کشفیات جدید من!

حدودا یک ماه هست که دارم روی سوییچ بانک رفاه و بانک مسکن کار می‌کنم. کدهایی که توسط آدم‌های واقعا باسواد و حرفه‌ای نوشته شده، ولی به چند تا نکته جالب پی بردم:
۱- اهمیت مستند سازی: تقریبا برای این دریای کد، مستندی نوشته نشده، و من کاملا مجبور شدم با لیوان این دریای کد رو بخونم تا متوجه شم توش چه خبره! فقط یک مستند قدیمی از روال‌ها بود که بواسطه اون توستنم روال‌ها رو بفهمم و … و هنوز هم درگیرشم.
۲- اهمیت نام‌گذاری کلاس‌ها، توابع، متغیرها: با اینکه اکثر جاهای این دریا درست اسم‌گذاری شده بود، اما یه سری جاها کاملا مشهود بود که توسعه‌دهنده خسته شده و همینجوری یه اسم نوشته و رفته!
۳- اهمیت کامنت نویسی: مزخرف‌ترین جای این دریا همین بود! جز یک فایل، عملا هیچ جای این دریای بزرگ کامنتی نداشت!
داشتم به کد‌های خودم توی شرکت قبلی فکر می‌کردم که الان کسی که داره روشون کار می‌کنه چه حالی داره! به خاطر همین تصمیم گرفتم که از کدهایی که خودم به سوییچ اضافه می‌کنم شروع به کامنت‌نویسی و مستندسازی کنم تا به بقیه کد‌ها برسم، این‌طوری نفرات بعد از من لاقل نقشه راهی برای فهمیدن این دریا و غرق نشدن داخلش دارن.