robotdotnet / WPILib

DotNet implementation of WPILib for FIRST Robotics Competition (FRC)
27 stars 8 forks source link

Change documentation system to DocFX #105

Closed jkoritzinsky closed 7 years ago

jkoritzinsky commented 8 years ago

DocFX is simpler than Sandcastle and has official support from Microsoft. Additionally, the search/filter function is Javascript-based, so it will work even when we host on GitHub Pages. It also looks better.

ThadHouse commented 8 years ago

That looks really cool. Glad to see an officially supported documentation tool from microsoft again.

ThadHouse commented 8 years ago

It still looks like we're going to need the individual sandcastle projects to generate the xml docs, but that's fairly easy as that does not require maintaining. But it would for sure be nice to get the site completely moved over.

ThadHouse commented 7 years ago

Got this started over on the https://github.com/robotdotnet/WPILib-Docs repo. Sandcastle didn't support building web docs for project.json, so we had to move. This is much easier however.