دليل Azure DevOps

كل صفحة في هذا القسم تفهرس نظامًا يحمل الحالة الحقيقية. هذا الـ wiki ليس أبدًا مصدر الحقيقة لمحتوى الـ boards أو الـ pipeline YAML أو الـ branch policies — كلها تعيش في Azure DevOps، ونربط إليها بدل نسخها. وإذا اختلفت صفحة هنا مع الأداة، فالأداة هي الصحيحة والصفحة عيب يجب إصلاحه. كل صفحة في هذا القسم تنقل الحالة المرصودة — ما هو مضبوط فعلًا — لا ما هو مطلوب. المطلوب يعيش في صفحة المعيار نفسها، والفرق بين الاثنين هو انحراف (drift) يجب ردمه: فالضبط الذي يقصّر عن المعيار لا يُعيد تعريفه بصمت. انظر أي صفحة تكسب.

أين يعيش كل شيء

flowchart LR
  WI["Work item<br/>Boards"] --> Br["Branch<br/>Repos"]
  Br --> PR["Pull request<br/>+ branch policies"]
  PR --> CI["PR pipeline<br/>Pipelines"]
  CI --> Env["Environment ladder<br/>Environments"]

في هذا القسم

• الـ Branching والـ Pull Requests — GitHub Flow، وPRs صغيرة، وتسمية الـ branches والـ commits، وسياسة المراجعة التي تفرضها الـ branch policies.
• اللوحات وعناصر العمل — هيكلية عناصر العمل، والـ flow board، وحدود الـ WIP، وكيف يرتبط الـ branch بمعرّف عنصر العمل.
• الـ Pipelines والبيئات — ما الذي يُشغّله كل PR pipeline، والترويج بمبدأ «ابنِ مرة واحدة»، والـ migrations لكل بيئة، وأين تعيش الأسرار فعليًا.
• توفير مشروع جديد — قائمة التحقق القابلة للتكرار التي تُهيّئ كل ارتباط عميل جديد بنفس الطريقة في كل مرة.