Re: Boost website changes and .'cxxstd'

From: Edward Diener (eldiener_at_[hidden])
Date: 2021-01-22 12:42:20

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 <dndikaio_at_[hidden]> 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 <louis_at_[hidden]> 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_at_[hidden]> 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_at_[hidden]> 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
>