Orbit · Explore

برنامه‌نویس‌های فارسی‌زبان · by Mango River · 2026-10-29

چرا هیچ‌کس درباره‌ی مستندسازی کد حرف نمی‌زنه؟

سه هفته‌ست که پروژه‌ی یه همکار قدیمی رو تحویل گرفتم. هیچ README نداره، اسم متغیرها x1 و temp2 و data_final_final هست و هیچ کامنتی هم نیست. هر بار یه تغییر کوچیک می‌دم یه جای دیگه می‌شکنه.

از خودم قول گرفتم از این به بعد حداقل یه README درست و حسابی و چندتا تست برای هر پروژه بنویسم. شما چه عادت‌هایی برای قابل فهم کردن کدتون دارید؟

38 sparks · 3 comments

Comments

Budi Santoso · 2 likes

من قانونم اینه کامنت برای چرا، نه برای چی. کد خودش باید بگه چی کار می‌کنه

Chloe Davis · 0 likes

این قانون رو باید رو دیوار هر شرکتی زد

Youssef Mahmoud · 0 likes

data_final_final منو کشت 😂 ما یه پوشه داشتیم به اسم new_new_last