Hello, I am writing to update you on the recent activities of The C++ Alliance. Our newest team members include Matt Borland, Ruben Perez. Matt is developing Boost.Charconv, a C++11 library which polyfills the equivalent C++17 functionality, and contributing to the maintenance and improvement of Boost.Math. Ruben is making significant improvements to Boost.MySQL. Our long-running Boost website project continues to progress and will be deployed in beta this year. As some authors and maintainers may have observed, the code coverage services provided by https://codecov.io have been varying greatly in quality in terms of the user experience of viewing the reports, with the experience being typically worse. To mitigate these risks we are researching the development of a new set of HTML, CSS, and JS templates for presenting high quality coverage reports in the original style. In our continuous efforts to improve documentation quality we have contracted HDoc to explore generating Doxygen compatible XML output so that we might move away from Doxygen in favor of HDoc. This tool is focused specifically on C++ and could be a better fit for Boost libraries that currently use Doxygen. Our vision for documentation includes a significant investment in Asciidoc as the choice of markdown. This means rendering Doxygen/HDoc output in Asciidoc and commissioning a great set of stylesheets for Asciidoc to replace the stock sheets. In the longer term we are investigating Antora as a solution for producing documentation that is well integrated into the new website, to offer a better navigation experience, improved accessibility, more features such as C++ syntax highlighting and code snippet interactivity, and others. We are excited to work on these developments, with the hope they will add vitality and enhance Boost. We look forward to sharing more updates with you in the near future. Best regards Louis Tatta CEO The C++ Alliance
On Thu, 2 Feb 2023 at 23:49, Louis Tatta via Boost
To mitigate these risks we are researching the development of a new set of HTML, CSS, and JS templates for presenting high quality coverage reports in the original style.
Louis, Do you mean capturing codecov.io reports and applying custom styling or capturing gcc/clang coverage reports and applying the styling?
In our continuous efforts to improve documentation quality we have contracted HDoc to explore generating Doxygen compatible XML output so that we might move away from Doxygen in favor of HDoc.
I like the idea very much.
Our vision for documentation includes a significant investment in Asciidoc as the choice of markdown. This means rendering Doxygen/HDoc output in Asciidoc and commissioning a great set of stylesheets for Asciidoc to replace the stock sheets. In the longer term we are investigating Antora
I like it even more. It will motivate me to switch GIL to Asciidoc. Best regards, -- Mateusz Loskot, http://mateusz.loskot.net
On Fri, Feb 3, 2023 at 2:32 AM Mateusz Loskot via Boost
Do you mean capturing codecov.io reports and applying custom styling or capturing gcc/clang coverage reports and applying the styling?
This is restyling the reports as they are generated by lcov. These are stock reports: https://31.http-proto.prtest.cppalliance.org/gcovr/index.html https://31.http-proto.prtest.cppalliance.org/genhtml/index.html We think they could be better :) Regards
participants (3)
-
Louis Tatta
-
Mateusz Loskot
-
Vinnie Falco