12.4 release notes: add the (expected) date

[grahamperrin]

Summary

Generally: it is fairly commonplace for release notes to include the date of release.

FreeBSD release notes (traditionally): without a date, the reader can step away then find the information elsewhere (maybe https://www.freebsd.org/security/#sup, or an announcement, or the schedule).

Consider including the release date in this set of notes, and in future sets.

Test Plan

Preview in GitHub:

• https://github.com/grahamperrin/freebsd-doc/blob/12-4-relnotes-date/website/content/en/releases/12.4R/relnotes.adoc

– branch 12-4-relnotes-date in my fork.

[grahamperrin]

website/content/en/releases/12.4R/relnotes.adoc

19

5 or 5th?

To me (British English), 5th seems more natural.

https://docs.freebsd.org/en/books/fdp-primer/writing-style/#writing-style-guidelines suggests American English for spelling, I don't know whether this encompasses dates. Neither do I know whether 5th December 2022 would look weird to an American.

---

Alternatively, 2022-12-05, although I reckon that longhand will look better in this context.

[zlei]

website/content/en/releases/12.4R/relnotes.adoc

19

Recent history release note use date format December 7, 2021, see [1] and [2]

Both 5 December 2022 and December 5, 2022 look good to me, but I'd prefer the latter for consistence.

[1] https://www.freebsd.org/releases/13.1R/announce/
[2] https://www.freebsd.org/releases/12.3R/announce/

[grahamperrin]

website/content/en/releases/12.4R/relnotes.adoc

19

Interesting, thanks.

I chose date (number) before month for consistency, because I'm more familiar with this order at pages such as these:

• https://www.freebsd.org/news/newsflash/
• https://www.freebsd.org/security/#sup
• https://www.freebsd.org/releases/12.3R/schedule/
• https://www.freebsd.org/releases/12.4R/schedule/
• https://www.freebsd.org/releases/13.1R/schedule/.

I guess, we should change the order, for consistency with the other date, which is already within the page:

• https://www.freebsd.org/releases/12.4R/relnotes/.

[grahamperrin]

https://github.com/grahamperrin/freebsd-doc/commit/4d81e23ebff99e6a6f9f3b1419f735422cf82c03

12.4 release notes: date: month, comma day year

Comment https://reviews.freebsd.org/D37528#inline-230337: done.

[grahamperrin]

https://github.com/grahamperrin/freebsd-doc/commit/65fe19e2a3ac0d74ca4b9bda504b098995debb0a

5 December 2022, in that order, because both tables under https://www.freebsd.org/releases/12.4R/relnotes/#security-errata present dates in that way.

[grahamperrin]

Abandon?

[gjb]

In D37528#855219, @grahamperrin wrote:

Abandon?

Yes. This is part of the final release wrap-up.

[grahamperrin]

Branch https://github.com/grahamperrin/freebsd-doc/tree/12-4-relnotes-date deleted.

Looking ahead: consider having a release date near the head of release notes for 13.2.