الكود أولًا مقابل العقد أولًا

في هذا الدرس

compare the two ways of producing a spec.

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

• Code-first: write controllers, generate the spec. Fast and always matches the code; the design can become an afterthought.
• Contract-first: write the spec first, then generate or hand-write code to match. Good for reviews and parallel work with client teams; needs discipline to keep code in sync.
• The main risk of both is docs drifting from behavior; check the spec in tests or in CI.
• Commit the spec to the repository so changes show up in code review.
• Many teams use code-first for internal APIs and contract-first for public or partner APIs.