. NET Magic Hall: Extract Comment Generation API documentation

Source: Internet
Author: User

First, preface

In a multi-person collaborative project, in addition to good code specifications, the complete API documentation is also very important. Through the documentation we quickly understand the actual interface of each module of the system, its usage scenarios, use examples to reduce communication costs to a certain extent, and reduce the risk of loss of knowledge in later maintenance.

For. Net, we can directly convert the annotations of classes, methods, etc. directly to the API documentation, greatly reducing the workload of document maintenance, while also reversing the quality of everyone's comments.

Below we use. NET unique annotation generation API documentation Tool--sandcastle and Sandcastle Help file Builder to automate the API documentation!

Second, the tool

Sandcastle: http://sandcastle.codeplex.com/

Sandcastle help File Builder:http://shfb.codeplex.com/

Iii. from annotations to API documentation

1. Generating an XML document file

Step: 1. In VS, right-click the assembly, select Properties, select the Build page, tick the "XML document File"

2. After compiling the assembly, you can find the assembly name under the build directory. XML "file.

2. Using SandcastleBuilderGUI.exe to generate API documentation

After installing the tools Sandcastle and Sandcastle help File Builder, click SandcastleBuilderGUI.exe to access the Document Generation project interface.

Step: 1. Configure Document Basics: Click the "Help File" page

Follow, configure document title, document name, document language, document style.

2. Load the assembly DLLs and XML files into the document build project.

Right-click Documentation Sources, select Add documentation Sources, and then add the assembly DLL and XML in.

3. Generate API Documentation

Click "Build Project", "Documentation" on the menu bar, and you can find the API documentation just in the same directory as the Sandcastle help File Builder.exe.

Iv. Summary

Only some of the features of Sandcastle help File Builder are described above and will be replenished later.

Respect the original, reprint please indicate from: http://www.cnblogs.com/fsjohnhuang/p/3968313.html ^_^ Fat Boy John

V. References

http://guojun2sq.blog.163.com/blog/static/643308612010116394430/

http://www.boyd.cn/info_Show.asp?ArticleID=4945

http://blog.csdn.net/chtnj/article/details/8278342

http://blog.csdn.net/chtnj/article/details/8278360

If you think the content of this article is interesting, please sweep it! Donate one another!

. NET Magic Hall: Extract Comment Generation API documentation

Contact Us

The content source of this page is from Internet, which doesn't represent Alibaba Cloud's opinion; products and services mentioned on that page don't have any relationship with Alibaba Cloud. If the content of the page makes you feel confusing, please write us an email, we will handle the problem within 5 days after receiving your email.

If you find any instances of plagiarism from the community, please send an email to: info-contact@alibabacloud.com and provide relevant evidence. A staff member will contact you within 5 working days.

A Free Trial That Lets You Build Big!

Start building with 50+ products and up to 12 months usage for Elastic Compute Service

  • Sales Support

    1 on 1 presale consultation

  • After-Sales Support

    24/7 Technical Support 6 Free Tickets per Quarter Faster Response

  • Alibaba Cloud offers highly flexible support services tailored to meet your exact needs.