Publish human-readable docs

[thekaveman]

Visual Studio is generating XML documentation from the source code. This should be turned into something a person can navigate and understand easily.

[thekaveman]

Some ideas for publishing include

• GitHub wiki on this repository
• GitHub pages site

[allejo]

sharpDox - Example

• Lightweight
• Looks flat and clean
• Only supports CHM and HTML

SHFB - Example

• Robust
• MSDN style
• Supports exporting in multiple formats out of the box (chm, html, md, docx, mshc)

Doxygen - Example

• Incredibly robust and thorough; there's a lot you can/should configure
• Classifies and organizes things in several different manners
• Several output formats

All

• are extensible through plug-ins
• command line utilities (can be used to automate generation)
• free and open source

There are other options but they're either not straightforward or they haven't been too active recently:

• Docu
• Nocco
• Natural Docs