4 Minor Cons

將API設(shè)計描述放在實現(xiàn)類注釋(comment)中，然后通過工具解析抽取并生成文檔是保持文檔和代碼同步的最便捷方式，也更容易集中于一點進行維護，但靈活度會收到原有語言語法的限制。

前者對于強類型語言的實現(xiàn)方案比較合適，而使用結(jié)構(gòu)化的文本來描述API設(shè)計，則更靈活，唯一的不足可能文檔的更新同步某些時候會不夠及時，當然， 如果完全遵循API design and documentation的思路和流程，則可以盡可能的規(guī)避這一不足。

對于實現(xiàn)和API規(guī)范同步的問題， 一種思路是根據(jù)API規(guī)范生成測試集， 然后“打到”最終實現(xiàn)，如果不通過，則要求要么更新API規(guī)范，要么更新代碼實現(xiàn)。 這樣， 可以基本可以保證二者的同步。當然，這樣的做法其實更像是先實現(xiàn)，后出API規(guī)范文檔， 與API設(shè)計和文檔化驅(qū)動的做法還是有些差異的。