將API設計描述放在實現類注釋(comment)中，然后通過工具解析抽取并生成文檔是保持文檔和代碼同步的最便捷方式，也更容易集中于一點進行維護，但靈活度會收到原有語言語法的限制。 前者對于強類型語言的實現方案比較合適，而使用結構化的文本來描述API設計，則更靈活，唯一的不足可能文檔的更新同步某些時候會不夠及時，當然， 如果完全遵循API design and documentation的思路和流程，則可以盡可能的規避這一不足。 > 對于實現和API規范同步的問題， 一種思路是根據API規范生成測試集， 然后“打到”最終實現，如果不通過，則要求要么更新API規范，要么更新代碼實現。 這樣， 可以基本可以保證二者的同步。當然，這樣的做法其實更像是先實現，后出API規范文檔， 與API設計和文檔化驅動的做法還是有些差異的。