Re: [boost] Boost website changes and .'cxxstd'

22 Jan 2021

      On 1/20/2021 11:47 PM, Donovan Dikaio via Boost wrote:
...
Hi Edward,
I have updated the 'C++ Minimum' sort in the libraries page.
So the libs with 'cxxstd' values will appear first in the sort by 'C++
Minimum', and then the ones without the values sorted by their names.
I also increased the width of the ‘C++ Standard Minimum Level’ label in the
new update.
This may show up after clearing the browser cache.
Looks good, thank you !

I have slogged through the task of creating PRs for all Boost libraries, 
even the very many C++03 minimum standard libraries, so that each 
library would have a 'cxxstd' value in their JSON meta information. It 
is up to the various library maintainers if they want to accept the PR 
or not, and a great many of them already have. Hopefully the final 
result will be that all Boost libraries will show a ‘C++ Standard 
Minimum Level’ in the documentation page. For those libraries that do 
not want to show such information, and ignore my PR for that library, 
end-users can ask the library maintainer(s) directly what the C++ 
Standard Minimum Level" is through the libraries Github page.

I do recall seeing somewhere in the Boost website an explanation of the 
meaning of the various fields shown for each library's documentation, 
but I can not recall where this is anymore. If such an explanation area 
still exists it would be nice adding to it some explanation about what 
the ‘C++ Standard Minimum Level’ field means, such as:

"This information shows the minimum C++ standard compilation level 
needed to use the functionality of a Boost library. The library may 
still have some enhanced functionality which takes advantage of a higher 
C++ standard compilation level, but the end-user is asked to read the 
library's documentation to determine if that is the case. If no ‘C++ 
Standard Minimum Level’ exists for a library it is up to the end user to 
read the documentation, or communicate with the library's maintainer(s) 
through the library's Github page, to determine this information."
...
Thank you,
Donovan
On Wed, Jan 13, 2021 at 12:37 PM Donovan Dikaio  wrote:
...
Hi Edward,
I have added a secondary sort by library's name for libraries which have
the same cxxstd value when sorting by 'C++ Minimum'.
It's up and available now here:
https://www.boost.org/doc/libs/master?sort=cxxstd
Please let me know if you have any more feedback.
Thank you,
Donovan
On Tue, Jan 12, 2021 at 9:51 AM Louis Tatta  wrote:
...
Hi Edward,
Donovan has updated the website:
Remove 'Standard' field from each library info
Remove 'Standard Proposals' and 'TR1 libraries' from sort categories
Add 'C++ Minimum' to sort categories
Please let me know if you want any other changes.
Thank You
Louis
On Fri, Jan 8, 2021 at 10:46 AM Edward Diener via Boost <
boost@lists.boost.org> wrote:
...
On 1/7/2021 7:05 PM, Louis Tatta via Boost wrote:
...
Hello Edward,
I'm with the CPP Alliance.  I'm working with Donovan to implement the
Boost
website changes and .'cxxstd'.
Reading the messages on the boost mailing list, we see some changes
requested and some asking not to implement the change. Can be a bit
confusing on what is needed or wanted.
Can we get a list of changes requested on the current implementation?
The initial change has been done correctly, which is to provide a "C++
standard minimum level" display field for each library which has its
JSON field of "cxxstd" set to some value. I also have agreed with Peter
Dimov's remark, which was also suggested earlier in this thread, that
the "Standard" display field for each library should be removed, since
it's meaning is obsolete and now also confusing. I have also suggested
that if we are removing the "Standard" display field we should also
remove the "Standard Proposals" and "TR1 libraries" sort categories,
which are likewise obsolete.
I personally think that since we now have a "C++ standard minimum level"
display field it would also be nice to be able to have a sort category
based on that display field called, let's say, "C++ Minimum".
...
Thank You
Louis
On Wed, Jan 6, 2021 at 6:16 PM Edward Diener via Boost <
boost@lists.boost.org> wrote:
...
On 1/6/2021 5:44 PM, Peter Dimov via Boost wrote:
> Donovan Dikaio wrote:
>
>> The updates to show "C++ standard minimum level" is just live here:
>> https://www.boost.org/doc/libs/master/
>
> Looking at this, I think that we need to drop the "Standard" part.
It's
...
...
> mostly empty, the places it says things like "TR1" aren't helpful,
and
> it's easy to misinterpret it as the minimum required C++ level.
I fully agree. Also the top line which give different views of the
library documentation can probably drop the "Standard Proposals" and
"TR1 libraries" views, since these are really obsolete by now.
_______________________________________________
Unsubscribe & other changes:
http://lists.boost.org/mailman/listinfo.cgi/boost
_______________________________________________
Unsubscribe & other changes:
http://lists.boost.org/mailman/listinfo.cgi/boost
_______________________________________________
Unsubscribe & other changes:
http://lists.boost.org/mailman/listinfo.cgi/boost
_______________________________________________
Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost