Re: Release Notes: Markdown to replace QBK

From: Mateusz Loskot (mateusz_at_[hidden])
Date: 2023-02-17 22:21:12

On Fri, 17 Feb 2023 at 20:40, Peter Dimov via Boost
<boost_at_[hidden]> wrote:
> Vinnie Falco wrote:
> >
> > * Each author will edit the release notes for their library using markdown
> > instead of Quickbook format, as a pull request against a file
> > here:
> >
> > <https://github.com/boostorg/website/tree/master/feed/history>
> >
> > The syntax will be GitHub flavored markdown, with a few Boost-specific
> > extensions (for example, to link against an issue in a boostorg repo).
> >
> > Does anyone object or have comments about this?
>
> The pull request workflow isn't very elegant. It would be better if, say,
> every author updates meta/release_notes.md in his repo, and the website
> automatically compiles these (as it currently does for meta/libraries.json).

I second that.

For GIL, we maintain notes in RELEASES.md which then for Boost
release we copy and reformat them to QuickBook manually. Silly.

Best regards,
-- 
Mateusz Loskot, http://mateusz.loskot.net