Hacker News new | ask | show | jobs
by hdoc 1967 days ago
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 requires disproportionate effort that could be better spent elsewhere. Furthermore, existing tools have a hard time dealing with modern C++.

We made hdoc to solve these problems: prioritizing the quality of output, making the developer experience seamless, and retaining compatibility with existing best practices.

hdoc lets you generate reference API documentation and put supporting guides, tutorials, how-tos right alongside your other docs. We have a sample of what hdoc's output for LLVM+Clang: https://docs.hdoc.io/hdoc/llvm-project/. The source for the repo is available here: https://github.com/hdoc/llvm-project/

Use the code HDOC-HN-LAUNCH for your first three months free when you sign up. 5 codes are available.