Proposal: "Newly Endorsed Libraries" section in release notes
The release notes currently cover changes to libraries shipped in each Boost release. I'd like to propose adding a small, clearly separated section called "Newly Endorsed Libraries" that lists libraries endorsed on this mailing list since the previous release. Endorsement is a community action with a public record on this list. Reporting it in the release notes documents a Boost ecosystem event, not an editorial judgment. The section would be agnostic: any library endorsed through the standard process qualifies, regardless of author or affiliation. The motivation is practical. Libraries that come to formal review with an existing user base get better reviews. A brief mention in the release notes, where attention is highest, gives endorsed libraries visibility among exactly the people most likely to test them and participate in the review. Proposed format: a short entry per library with the library name, a one-line description, a link to the endorsement thread, and a link to the library's repository. Nothing more. If there's interest I'll draft a concrete example for the 1.91 release notes. Vinnie
Vinnie Falco wrote:
The release notes currently cover changes to libraries shipped in each Boost release. I'd like to propose adding a small, clearly separated section called "Newly Endorsed Libraries" that lists libraries endorsed on this mailing list since the previous release.
I don't think this belongs in the release notes. Release notes are notes about the release, and these "newly endorsed libraries" are not part of it.
On March 9, 2026 5:39:24 PM Peter Dimov via Boost <boost@lists.boost.org> wrote:
Vinnie Falco wrote:
The release notes currently cover changes to libraries shipped in each Boost release. I'd like to propose adding a small, clearly separated section called "Newly Endorsed Libraries" that lists libraries endorsed on this mailing list since the previous release.
I don't think this belongs in the release notes. Release notes are notes about the release, and these "newly endorsed libraries" are not part of it.
I agree. I think, such information could be added to a different document. We used to have periodic review wizards' reports, although we haven't had one for quite a while. Also, we have a page with review history.
On Mon, Mar 9, 2026 at 10:23 AM Andrey Semashev via Boost < boost@lists.boost.org> wrote:
On March 9, 2026 5:39:24 PM Peter Dimov via Boost <boost@lists.boost.org> wrote: ...
tl;dr for Peter: Low visibility produces few early adopters. Few early adopters produce thin reviews. Thin reviews produce costly libraries. Costly libraries produce low visibility. Four lines in the release notes break the cycle at the cheapest point. wall of text for Andrey: I do hear the scope objection, but I think the premise is narrower than the release notes actually are. The release notes have never been limited to code changes in the tarball. Every release notes page has a "New Libraries" section that reports an ecosystem event - a library passed review during this cycle. The notes also list removed libraries, updated tools, and known issues. The scope already includes "things that happened to Boost since the last release." An endorsed library is one step earlier in the same pipeline. Endorsement is a formal community action with a public record on this list. Reporting it is no different in kind from reporting that a new library was accepted or a tool was updated. Now the practical argument. Peter, you wrote in October 2023: "Reviews from users count more than reviews from non-users, of course." And just last November: "We're between a rock and a hard place here; on one hand, we suffer from a lack of volunteers who would want to manage reviews." If reviews from users carry more weight, and we don't have enough reviewers, then anything that increases the number of people who have actually used a library before its review directly improves the process you're defending. Andrey, you diagnosed this problem sixteen years ago. In March 2010 you wrote: "Boost is rather closed to its community. I don't know how it happens, but on independent news I regularly read of such projects as KDE, GNOME, Qt, Linux Kernel and others, but nearly nothing about Boost. The Boost web site changes rarely - essentially, the news column only lists recent Boost releases. For an outsider, nothing really happens around Boost, and that's sad. If Boost was more open and communicated to the public, I think, there would be much more activity in Boost, and during reviews in particular." That is exactly the problem this proposal addresses. The release notes are the one document where outsiders actually look. A library that arrives at formal review with zero early adopters produces a worse review. A worse review produces a library that costs more to maintain after acceptance. The release notes are the only document with enough readership to materially change the size of that early-adopter pool. Putting this information anywhere else is choosing a smaller audience for the information that feeds review quality. Andrey, you also pointed out in that same thread: "We are also suffering from a lack of reviewers. While we all understand time pressures and the need to complete paying work, the strength of Boost is based on the detailed and informed reviews submitted by you." Four lines in the release notes - name, one-line description, link to the endorsement thread, link to the repository - is a low-cost way to put endorsed libraries in front of exactly those people. The proposed section would be clearly separated from the rest of the notes. It does not editorialize. It reports a fact: these libraries were endorsed by this community since the last release. I think the benefit to review quality justifies four lines in a document whose scope already includes ecosystem events. Vinnie
Vinnie Falco wrote:
I do hear the scope objection, but I think the premise is narrower than the release notes actually are. The release notes have never been limited to code changes in the tarball. Every release notes page has a "New Libraries" section that reports an ecosystem event - a library passed review during this cycle. The notes also list removed libraries, updated tools, and known issues. The scope already includes "things that happened to Boost since the last release."
All of these things refer to what's in the release. As in, physically present in the archive.
On March 9, 2026 10:52:26 PM Vinnie Falco <vinnie.falco@gmail.com> wrote:
tl;dr for Peter:
Low visibility produces few early adopters. Few early adopters produce thin reviews. Thin reviews produce costly libraries. Costly libraries produce low visibility.
Four lines in the release notes break the cycle at the cheapest point.
Unrelated content makes release notes less useful to the intended reader, to the point of being annoying.
wall of text for Andrey:
I do hear the scope objection, but I think the premise is narrower than the release notes actually are. The release notes have never been limited to code changes in the tarball. Every release notes page has a "New Libraries" section that reports an ecosystem event - a library passed review during this cycle.
No, it reports what's been added to the release. If a library has passed the review but has not been included in the release (e.g. due to a review ending too late), it wouldn't be mentioned in the notes.
The notes also list removed libraries, updated tools, and known issues. The scope already includes "things that happened to Boost since the last release."
Not what happened but what changed in the new release. Endorsement is not such a change.
An endorsed library is one step earlier in the same pipeline. Endorsement is a formal community action with a public record on this list.
To be frank, I never fully understood the point of endorsement. If I endorse a library, does it mean I'm obligated to write a review? It's a difficult promise to make since endorsements are made before the review time frame is set. And since I bothered to endorse, does it mean I promise my review will be positive? I don't remember examples of the opposite. I don't think the answers to the above questions should be "yes". I guess, you can consider endorsements as an indication of community interest, but not more than that. There are many ways to express interest, why not report on that? If anything, I would rather the repotring increased the interest to the proposed library, regardless of endorsements. A news item on the web site about a proposed library with a short description and an invitation to discuss and review it would be a good thing.
Reporting it is no different in kind from reporting that a new library was accepted or a tool was updated.
Yes, but where that reporting is done matters. Release notes is not the right place, as endorsements are not relevant to the purpose of that document.
Andrey, you diagnosed this problem sixteen years ago. In March 2010 you wrote: "Boost is rather closed to its community. I don't know how it happens, but on independent news I regularly read of such projects as KDE, GNOME, Qt, Linux Kernel and others, but nearly nothing about Boost. The Boost web site changes rarely - essentially, the news column only lists recent Boost releases. For an outsider, nothing really happens around Boost, and that's sad. If Boost was more open and communicated to the public, I think, there would be much more activity in Boost, and during reviews in particular."
That is exactly the problem this proposal addresses. The release notes are the one document where outsiders actually look.
That's not *why* they look in that document. They come there for one purpose and the document must serve that purpose well. You've made a new beautiful website, use it to better expose proposed libraries. You have socials to notify people.
On Tuesday, March 10, 2026, Andrey Semashev via Boost
To be frank, I never fully understood the point of endorsement. If I endorse a library, does it mean I'm obligated to write a review?
If I remember correctly, Niall proposed that practice along with a pull request to the website page defining the review submission process. None of us objected, presumably because we were all so happy Niall was writing HTML instead of C++. I haven't seen any library not being endorsed recently, so if the step in the process is largely performative we can decide if it serves any real purpose today. Glen
В письме от вторник, 10 марта 2026 г. 14:32:30 MSK пользователь Glen Fernandes via Boost написал:
On Tuesday, March 10, 2026, Andrey Semashev via Boost I haven't seen any library not being endorsed recently, so if the step in the process is largely performative we can decide if it serves any real purpose today.
I remember at least one library proposal in the last few years that wasn't endorsed. So, I think endorsement still has some value.
On March 10, 2026 2:47:28 PM Peter Dimov via Boost <boost@lists.boost.org> wrote:
Andrey Semashev wrote:
To be frank, I never fully understood the point of endorsement.
The point of endorsement was to prevent libraries that weren't ready for formal review to have such scheduled and thereby waste everyone's time.
I don't remember there being an influx of underprepared libraries. IIRC, endorsements were an attempt to prevent review periods with no submitted reviews. We didn't have those for a while, but we still did have review periods with little reviews, so I'm not sure how successful that attempt was. Anyway, as I said, there are many ways to express interest in the library and a (non-binding) intention to review it. It's the formality of the act of endorsement and what it entails for the one who endorses is what I don't like or understand.
Andrey Semashev wrote:
On March 10, 2026 2:47:28 PM Peter Dimov via Boost <boost@lists.boost.org> wrote:
Andrey Semashev wrote:
To be frank, I never fully understood the point of endorsement.
The point of endorsement was to prevent libraries that weren't ready for formal review to have such scheduled and thereby waste everyone's time.
I don't remember there being an influx of underprepared libraries. IIRC, endorsements were an attempt to prevent review periods with no submitted reviews. We didn't have those for a while, but we still did have review periods with little reviews, so I'm not sure how successful that attempt was.
Anyway, as I said, there are many ways to express interest in the library and a (non-binding) intention to review it. It's the formality of the act of endorsement and what it entails for the one who endorses is what I don't like or understand.
The formality was because the review wizard wasn't allowed to unilaterally decide to not schedule a review for a library, once such was requested.
В письме от вторник, 10 марта 2026 г. 11:56:54 MSK пользователь Andrey Semashev via Boost написал:
Unrelated content makes release notes less useful to the intended reader, to the point of being annoying.
As a sort of middle ground: we can have a link to the News section of the website on release notes page. It could be visually distinct and the text could identify it as something not release-related. Something like "Also check out other Boost news".
On Tue, Mar 10, 2026 at 12:07 PM Dmitry Arkhipov via Boost < boost@lists.boost.org> wrote:
В письме от вторник, 10 марта 2026 г. 11:56:54 MSK пользователь Andrey Semashev via Boost написал:
Unrelated content makes release notes less useful to the intended reader, to the point of being annoying.
As a sort of middle ground: we can have a link to the News section of the website on release notes page. It could be visually distinct and the text could identify it as something not release-related. Something like "Also check out other Boost news".
I like that idea. It is probably worth it to have general info links in all official communications. -- -- René Ferdinand Rivera Morell -- Don't Assume Anything -- No Supongas Nada -- Robot Dreams - http://robot-dreams.net
On March 10, 2026 8:06:38 PM Dmitry Arkhipov via Boost <boost@lists.boost.org> wrote:
В письме от вторник, 10 марта 2026 г. 11:56:54 MSK пользователь Andrey Semashev via Boost написал:
Unrelated content makes release notes less useful to the intended reader, to the point of being annoying.
As a sort of middle ground: we can have a link to the News section of the website on release notes page. It could be visually distinct and the text could identify it as something not release-related. Something like "Also check out other Boost news".
There already are links at the top of the release notes page, including News.
On Mon, 9 Mar 2026 at 13:33, Vinnie Falco via Boost <boost@lists.boost.org> wrote:
The release notes currently cover changes to libraries shipped in each Boost release. I'd like to propose adding a small, clearly separated section called "Newly Endorsed Libraries" that lists libraries endorsed on this mailing list since the previous release.
I support this. An endorsement is the first item in the list of things a library needs to get into boost, If the results of a review are included it seems natural to also include the endorsement. Letting them out lowers their status in the review process so why would anyone care. Marcelo
No dia 10 de mar. de 2026, às 21:03, Marcelo Zimbres Silva via Boost <boost@lists.boost.org> escreveu:
On Mon, 9 Mar 2026 at 13:33, Vinnie Falco via Boost <boost@lists.boost.org> wrote:
The release notes currently cover changes to libraries shipped in each Boost release. I'd like to propose adding a small, clearly separated section called "Newly Endorsed Libraries" that lists libraries endorsed on this mailing list since the previous release.
I support this. An endorsement is the first item in the list of things a library needs to get into boost, If the results of a review are included it seems natural to also include the endorsement.
Review results are not included in the release notes currently. Joaquín M López Muñoz
On Wed, 11 Mar 2026 at 00:03, Joaquín M López Muñoz via Boost < boost@lists.boost.org> wrote:
<snip> Review results are not included in the release notes currently.
https://www.boost.org/releases/latest/ New Libraries
OpenMethod: Open-(multi-)methods in C++17 and above, from Jean-Louis Leroy.
Perhaps I should have said *Review outcome.Marcelo*
El 09/03/2026 a las 13:31, Vinnie Falco via Boost escribió:
The release notes currently cover changes to libraries shipped in each Boost release. I'd like to propose adding a small, clearly separated section called "Newly Endorsed Libraries" that lists libraries endorsed on this mailing list since the previous release.
Hi, "Endorsement" is not even a relevant milestone thing in the Library submission process. The relevant step is when the library is added to the Review Schedule, then we can say an "official" step was done inside Boost. Release notes are about the released library, not about the community. My opinion is that we can use the Boost release announcement (which is an important event that might attract readers) to announce several things: - Main info: New release version with a summary of main changes and a link to the release notes. - "Relevant" stuff between this and the previous release: very brief summary (e.g. a review happened and the result of the review, one library added to the review schedule, and some details about the candidate) and a link to the Review Schedule and other info. This way the interested users can choose between reading the relevant changes in the library collection or have a broader look to the project activity. The project activity summary might be also a summary of published newsletters. Best, Ion
On Wed, Mar 11, 2026 at 1:04 AM Ion Gaztañaga <igaztanaga@gmail.com> wrote:
...
I really just want as many users as possible going into the review. I don't care how it happens. Release Notes is an obvious Schelling point. A lot of people read them and they are a natural audience (they are already Boost users). Thanks
participants (9)
-
Andrey Semashev -
Dmitry Arkhipov -
Glen Fernandes -
Ion Gaztañaga -
Joaquín M López Muñoz -
Marcelo Zimbres Silva -
Peter Dimov -
René Ferdinand Rivera Morell -
Vinnie Falco