我通過網絡服務暴露我的API（.asmx）。目前，唯一可用的是默認的WSDL幫助頁面。雖然這非常有幫助，但如果我的目標受衆需要更多手持，這還是不夠的。例如，讓我們說我想包括一些例子，但仍然需要方法簽名的自動生成等。我應該如何爲我的Web服務API生成文檔？
是否有一個很好的半自動（自動方法簽名，但仍然能夠提供示例）來實現這一目標？我正在尋找類似this這也是可維護的。理想情況下，幫助我修改默認的WSDL（我真的很喜歡那個頁面）會很棒。 我所需要的只是文檔在部署時隨服務一起自動提供。
有什麼建議嗎？
這很簡單。如果你用tripple ///註釋來修飾所有的類和方法，那麼你可以從中生成文檔。在這裏看到：
http://msdn.microsoft.com/en-us/library/dd233217.aspx
http://www.developerfusion.com/article/84436/documentation-made-easy-with-c-and-xml/
也許最簡單的方法是使用XML文檔註釋。
使用這些評論可以自動生成HTML文檔。例如使用Sandcastle或NDoc3：
Build Sandcastle Documentation When Building Visual Studio Project
而且畢竟你可以自動保存HTML文檔到共享位置靠近你的服務，它可以通過瀏覽器輕鬆地導航那裏。所以，所有可能會接近 - wsdl + html文檔
同意其他海報，但我已經使用NDoc3取得了很大的成功。它比Sandcastle快很多（這也是一個非常好的工具）。 NDoc3將創建.chm，.doc和.html輸出。
NDoc3和Sandcastle都生成MSDN樣式文檔。