wgtmac commented on issue #26: URL: https://github.com/apache/iceberg-cpp/issues/26#issuecomment-2586192832
I'm not an expert so I asked ChatGPT to search other alternatives for me: | Name | Pros | Cons | Links | |------|------|------|-------| | MkDocs with Doxybook2 | • Modern, clean look<br>• Fast build times<br>• Markdown support<br>• Excellent search functionality<br>• Mobile-friendly<br>• Easy customization<br>• Active community | • Requires Doxygen as intermediate step<br>• Additional setup complexity<br>• Two-step build process | • [MkDocs](https://www.mkdocs.org/)<br>• [Doxybook2](https://github.com/matusnovak/doxybook2)<br>• [Material theme](https://squidfunk.github.io/mkdocs-material/) | | DocFX | • Modern Microsoft-backed platform<br>• Multi-language support<br>• Clean design<br>• Good search capabilities<br>• Cross-platform | • Steeper learning curve<br>• More complex setup<br>• Originally designed for .NET | • [DocFX](https://dotnet.github.io/docfx/)<br>• [DocFX Guide](https://dotnet.github.io/docfx/tutorial/docfx_getting_started.html) | | Standardese | • Modern C++-specific<br>• Clean output<br>• Accurate C++ parsing (libclang)<br>• Markdown support<br>• Standard C++ documentation style | • Less mature than alternatives<br>• Smaller community<br>• Limited customization options | • [Standardese GitHub](https://github.com/standardese/standardese) | | cldoc | • Clean, modern output<br>• Accurate C++ parsing (Clang)<br>• Good C++11 support<br>• Simple configuration<br>• Static HTML generation | • Less active maintenance<br>• Limited themes<br>• Basic feature set | • [cldoc GitHub](https://github.com/jessevdk/cldoc) | | Natural Docs | • Language-agnostic<br>• Natural readable format<br>• Modern output<br>• Good organization<br>• Active maintenance | • Less C++-specific features<br>• Limited API documentation features<br>• Less flexible customization | • [Natural Docs](https://www.naturaldocs.org/)<br>• [Getting Started](https://www.naturaldocs.org/getting_started/) | -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: issues-unsubscr...@iceberg.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org --------------------------------------------------------------------- To unsubscribe, e-mail: issues-unsubscr...@iceberg.apache.org For additional commands, e-mail: issues-h...@iceberg.apache.org