توثيق يُقرأ فعلًا

في هذا الدرس

write docs people actually use.

الموضوعات المخطط لها

• Write for a named reader with a named question: new joiner, on-call engineer, reviewer.
• Keep docs next to the code (docs as code): reviewed in pull requests, versioned in git.
• Prefer a few short, current documents over many stale ones; give each an owner and a date.
• Document why, not what; the code already says what.
• Every diagram needs a title and a legend.