التوثيق كشيفرة (Docs as code)
في هذا الدرس 4 موضوعات
هذا الدرس مخطط له. يعرض المخطط أدناه الموضوعات التي سيغطيها، ولم يُنشر الدرس الكامل بعد.
نص الدروس والتمارين باللغة الإنجليزية، بينما تبقى واجهة الموقع وعناوين الدروس بالعربية.
في هذا الدرس
keep documents current by treating them like code.
الموضوعات المخطط لها
- Store docs in the repository beside the code; change them in the same pull request.
- Review docs; check links and diagram builds in CI.
- Give each document an owner and a review date.
- Delete or archive stale documents.
تفاصيل المخطط المبدئي
عرض عملي
a repository layout with docs/architecture, docs/adr, docs/runbooks, and a CI step checking links.
اختبر فهمك
Why change docs in the same PR as code?
أظهر الإجابة
So they stay accurate and are reviewed together.
التطبيق
طبّق هذا الدرس بمختبر الوحدة وتمارينها واختبارها.
تعليم الدرس كمكتمل اختياري ويمكنك التراجع عنه في أي وقت. يبقى تقدمك محفوظًا في هذا المتصفح.