نرم افزار مدل سازی و مستند سازی

[web_designer_1552]

دوستان نرم افزاری برای مدل سازی پروژه های php  مانند نرم افزار rational rose برای asp وجود داره ؟

[ADMIN]

حقیقتش تا حالا چنین نرم افزاری ندیدم ولی توصیه هم نمیکنم ازش استفاده کنید. کدی که یه نرم افزار بسازه، در اکثر موارد به هوشمندی و بهینگی کدی که خود انسان مینویسه نیست. خیلی وقتها برای انجام برخی کارها، راههای سریعتر و بهینه تری وجود داره که این نرم افزارها از اونها اطلاع ندارن. برای مثال، اگه میخواین درصورت زوج بودن، کلمه even و درغیر اینصورت کلمه odd چاپ بشه، کدی که ممکنه این برنامه ها تولید کنن میتونه این باشه:

if($x % 2 == 0) {
    echo 'even';
}
else {
    echo 'odd';
}

درحالی که یه انسان میتونه کد بهینه تر زیر رو بنویسه:

echo ($x & 1 ? 'odd' : 'even');

البته ناگفته نماند که نهایت کاری که ابزارهایی مثل Rational Rose و... میتونن انجام بدن، تولید کلاسها و امثال این کارهای ابتداییه و منطق برنامه رو نمیتونن تولید کنن.

[web_designer_1552]

من دنبال راهی هستم که بتونم مستنداتی برای پروژه هایی که انجام میدم تولید کنم ، که بقیه اعضای تیم بتونن بر اساس اون مستندات از کلاس های نوشته شده استفاده کنند. به عنوان مثال توی extension هایی که برای yii توی پروژه ها مینویسم مستندات کامل با توضیحات کامل قرار بگیره ( به صورت فارسی ، لاتین و ... ) که نفرات دیگه به راحتی بتونن از اون extension ها استفاده کنند .

[ADMIN]

درمورد PHPDoc و همچنین Doxygen و ضمناً Markdown تحقیق کنید.

[php_programmer021]

به نظرم این بحث خیلی مهم و جای کار داره خیلی از برنامه نویس ها برای مستند سازی پروژه با چالش روبرو میشن.اگر دوستان حرفه ای لطف کن روشهای رو که خودشون باهاش کار می کنن رو در اختیار بقیه قرار بدن خیلی عالی می شه.
با تشکر