Draft mode [ Re: Branch release-notes for Trixie? ]
Holger Wansing <[email protected]>
| Newsgroups | gmane.linux.debian.devel.documentation,gmane.linux.debian.devel.release |
|---|---|
| Message-ID | <[email protected]> |
Hi, Holger Wansing <[email protected]> wrote (Sun, 23 Aug 2026 22:32:07 +0200): > Hi, > > Am 23. August 2026 07:46:11 MESZ schrieb Paul Gevers <[email protected]>: > >After the migration to .rst format, do we still have the option to mark the release notes as draft? Might be good to use to avoid any doubt. > > I had already asked about that during the migration, and that time the answer was, there is need for this. > So I forgot about this. > > > However, the situation did not change since then: there are sphinx extensions like sphinx-watermark or sphinxmark for this, but sadly these extensions are (still) not in sphinx upstream and not in Debian. > > So I can only think about adding a "DRAFT - Not yet ready !!!" line in bold font on the first page... Some proposal: I have added a "---DRAFT---" string to the document title and all toplevel headlines of the document, which can be dynamically enabled or disabled via some lines in conf.py. The result can be seen at https://people.debian.org/~holgerw/release-notes-with-rudimental-draftmode/ I created a merge request for this [1]. I know that only rudimental, but maybe it's better than nothing, until we have a better solution??? Holger [1] https://salsa.debian.org/ddp-team/release-notes/-/merge_requests/348