Looking at the doc commit logs, there doesn't seem to be a convention about how to prefix the component as described in the Committer's Guide. In the ports tree, when we update a port, we use category/port, which is the path in the tree. This adds a slight convenience when doing something like git log --oneline because the location of the change can be seen without showing the commit. With that, how do you feel about this commit log?

website/shared/releases: Add missing version macro

The website currently fails to render the macro and presents a confusing "FreeBSD {rel142-current}-STABLE" and incorrect links.

PR: 282652
Reported by: Graham Perrin <grahamperrin@gmail.com>

Sounds good!

And it gives me the lead for another TODO: the commiter's guide article could probably benefit from an additional clarification on how to build a commit message for documentation updates on the handbook and website... :)

On second thought, I'm not sure we want a section for FreeBSD 14.2-STABLE when 14.2-BETA2 is available. Let's see what re@ as to say.

jrm added a reviewer: releng.Mon, Nov 11, 8:33 PM

In D47499#1083789, @jrm wrote:

On second thought, I'm not sure we want a section for FreeBSD 14.2-STABLE when 14.2-BETA2 is available. Let's see what re@ as to say.

Yes, we want that section.

Also, oops, I started using :rel142-current: without checking that it was defined. I'll add that to my release process list (bumping where.adoc to X.Y-STABLE is part of the X.Y release process).

This revision is now accepted and ready to land.Mon, Nov 11, 9:22 PM

In D47499#1083789, @jrm wrote:

On second thought, I'm not sure we want a section for FreeBSD 14.2-STABLE when 14.2-BETA2 is available. Let's see what re@ as to say.

Good thinking. I was wondering whether I might be breaking some release related processes when I re-read the header this morning.

Great. Thanks both. I'll commit now.

Closed by commit R9:bbf36388d0a4: website/shared/releases: Add missing version macro for FreeBSD 14.2 (authored by freebsd_ny-central.org, committed by jrm). · Explain WhyMon, Nov 11, 9:27 PM

This revision was automatically updated to reflect the committed changes.

jrm added a commit: R9:bbf36388d0a4: website/shared/releases: Add missing version macro for FreeBSD 14.2.