Viewing profile — hdoc

The preprocessor will still be run prior to hdoc parsing your code, and the result should be valid assuming the your code is well-formed. C++ AST dumps are generally incomprehensib…

hdoc uses Clang to parse your C++ code, so anything that Clang compiles should be fine. It's one of the benefits of using a production-quality parser instead of a homemade one like…

Hello HN, we've posted here several times but today we're announcing that hdoc is becoming open source. Our goal is to make hdoc available to a broader set of developers. On top of…

We're looking at open sourcing hdoc in the future, and at least offering a free plan in the near term. We'd like to give back to the community too, it's part of the reason why we h…

I agree that bad documentation is often due to lack of effort. Many developers don't like writing documentation, which is unfortunate because bad documentation can drag down otherw…

LLVM/Clang are generally well-documented but there are places that don’t have great coverage. Unfortunately tools are only part of the solution. Our goal with hdoc is to make writi…

Yes, this is one of the many improvements we plan on adding soon. It was cut from the MVP because we wanted to ensure that it was 100% accurate. Complex code bases can be ambiguous…

When we originally implemented the Doxygen command support we looked at the most used commands in the code bases we profiled, and settled on about five, which we cut down to those …

C++ is falling behind in the quality of documentation output compared to what tools like rustdoc, ReadTheDocs, and godoc generate. Getting good output from existing C++ tools requi…

https://hdoc.io/ More or less a modern replacement of Doxygen. The goal is to make writing good documentation easy. To accomplish that we've incorporated Markdown pages alongside t…

The hdoc alpha release is now available on Linux and we're looking for feedback from users. If you're interested in a better documentation tool for C++, please consider trying out …