Replies: 1 comment 18 replies
-
I'm reviewing many document generator tools.
There are more: https://en.wikipedia.org/wiki/Comparison_of_documentation_generators Some are not free, so I'm not seriously considering them. DocFX is Microsoft's, and seems like the most natural fit so far. It has a large number of features, is actively maintained, integrates well with the tools. I'm not sure right now how much work would be required to get something like a responsive site output so that the docs could be called up on a mobile device, for example, but also having a desktop site that is capable of delivering a rich experience. How important is it that the generation process includes good integration with IDE tools (VS, VSCode, ... Rider? Eclipse?)? |
Beta Was this translation helpful? Give feedback.
-
This is me introducing myself to the xUnit community and getting started on my pet project: bringing the overall documentation for xUnit to a higher quality than where it's at now. I don't have many details yet on what all that will mean, but at the start it will mean bringing back most (all?) of the reference docs that are currently absent from the documentation website. I have big ideas, but I'm new to being a long-term collaborator, so I'm expecting to just learn the ropes for now. That means going over all the issues and discussions related to documentation and digesting all of that before committing to anything beyond bringing back the reference docs.
Beta Was this translation helpful? Give feedback.
All reactions