On 12/15/2020 1:14 PM, Peter Dimov via Boost wrote:
Edward Diener wrote:
I had previously proposed that we tag the minimum C++ standard level for Boost libs by adding information to the json meta information in libraries.json for each library. I would like to revisit that proposal, which involved more elaborate suggestions, with this simpler overall proposal: for each Boost C++ library whose minimum C++ standard level is C++11 or above we add a json field called 'cxxstd' whose value corresponds to one of the same values as currently exists in Boost.Build for the 'cxxstd' feature, ie. 11,14,17,20, to the libraries.json file for that library. This json value can then be used in Boost documentation of each library to specify the minimum C++ standard level needed by an end-user in order to use that library. Obviously we can also add "cxxstd": "03" for the many Boost libraries which can still be used at the C++98/C++03 compilation level also, even though I would argue that not having a "cxxstd" json field should mean C++98/C++03 by default. I would be willing to create the necessary PRs for each library, as I have a pretty good internal list of this information.
The gist of this proposal is to make it much easier for end-users wishing to use a Boost library to immediately know whether the library they wish to use is usable at the C++ standard compilation level they are using for compilation, without having to spend time searching for such information, which is often not readily available, in the documentation of the library they are considering.
I see nothing wrong with adding this field to meta/libraries.json. However, libraries.json is not for end users. It's input to the scripts that generate the libraries page. So if we add the field, we should also change the scripts to read it and display it in the library list.
Unfortunately all those scripts were written and maintained by Daniel James who isn't available, so someone else would need to figure this out.
Does anybody else understand the Boost website and how it is programmed ? I can see the PHP code but I am not sure how this code is being called from the web pages or how web pages are being generated through the code. I have worked in the past with PHP before, it is not a complicated language, but I do not understand the interaction between the code and the web pages.