چه طوری برنامه خودمون رو مستند سازی کنیم ؟

[Darg]

خیلی عجیبه!!!!
اگر شما یخوایند برای 300 یا 400 خط فلوچارت رسم و نگه داری کنید به طور کامل از برنامه نویسی پشیمون می شید...
چه برسه به 20 یا 30 هزار خط !!!!!

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

حالا نه تو ایران و فکر می کنم در هیچ جای دنیا هیچ برنامه سازی فلوچارت پروژه خودش به طور واقعی و مثلا روی کاغذ
نداره.
این کار (ترسیم فلوچارت برای حفظ و مدیریت متغییر ها, ثابت ها و داده ها) اصلا به صرفه نیست. علتش کاملا روشنه
کافیه همون طور که گفتم شما فقط برای 300 تا 400 خط از کد هاتون اقدام به ایجاد فلوچارت عینی (موجود در دنیای واقعی و نه در فکرتون) بکنید. خواهید دید که صرف وقت و انرژی این کار اصلا شما رو برای ادامه کار منصرف می کنه.

پس هر برنامه نویسی باید بتونه در ذهن خودش خیلی از کار ها رو انجام بده و در عین حال روی همه اون 20 هزار خط کد
تمرکز داشته باشه... (بی خود نیست که می گند برنامه نویسی تمرکز رو بالا می بره)

اما شما برای کاری که می خوایند انجام بدید باید برگه هایی تهیه کنید که در اون برگه ها لیست متغییر ها و ثابت ها
و هر چیزی که برای هر زیر برنامه لازمه, ثبت بشه. درون کار های گروهی و پروژه های متوسط یا بزرگ از همچین
لیست هایی استفاده می شه تا در آینده برای خطا یابی و یا تکامل برنامه دچار مشکل نشند.
این لیست باید حاوی شرح عملکرد و وظایف هر جزء باشه (یعنی توابع, زیر برنامه ها و متغییر ها و ...)
علاوه بر این ها شما باید تاریخ کد نویسی قطعه, برنامه نویس (نام شخص) رو هم ثبت کنید تا مشخص باشه کِی و چه
کسی این قطعه رو نوشته.

همین طور در برنامه نویسی شیء گرا علوه بر موارد ذکر شده, مشخطات هر شیء, Parent و علت و وظیفه هر شیء
به خوبی لیست و سیاهه بندی می شه.

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