Bug#932957: no longer build arch-dependent variants of r-n?

2023-06-25 Thread Paul Gevers

Hi Holger,

On 25-06-2023 14:11, Holger Wansing wrote:

I have reduced the build chain to only build one generic arch-independent
variant of r-n, for all languages. It has all the content, and it's just named
"Release Notes for Debian 12 (bookworm)"
no longer mentioning any arch name in the title, and without any arch-name
reference in the whole document.


Great.


Note: If we decide to go with such approach, the website would need an
overhaul because of this!!!


Sure.


I added some sort of a basic-level draft mode:


To be fair, I'm not very attached to it. During the previous release 
(bullseye) I even had the notes in non-draft mode for (nearly) the whole 
preparation period. I'm not sure anybody took the notes for something 
they were not.


Paul



OpenPGP_signature
Description: OpenPGP digital signature


Bug#932957: no longer build arch-dependent variants of r-n?

2023-06-25 Thread Holger Wansing
Hi,

Holger Wansing  wrote (Sun, 18 Jun 2023 14:32:25 +0200):
> That gives us the possibility, to simplify the whole r-n thing to only build 
> one generic release-notes variant for all archs, in the different languages, 
> and we are done.
> 
> How does that sound?

Status update:

1.
I have reduced the build chain to only build one generic arch-independent
variant of r-n, for all languages. It has all the content, and it's just named
"Release Notes for Debian 12 (bookworm)"
no longer mentioning any arch name in the title, and without any arch-name
reference in the whole document.

Note: If we decide to go with such approach, the website would need an 
overhaul because of this!!!


2. 
I added some sort of a basic-level draft mode:
Sphinx does not have support for a watermark, as dblatex had (at least not 
in the sphinx version/packages we have in Debian; there is a contrib
extension 'sphinxmark' which does that, but that's not available in
Sphinx mainstream).

So I have just added a bold 
"DRAFT MODE - in development for the next release"
on the html index page.

Maybe someone has better ideas?
AFAICS we could go forward with this via using a different html layout
template, or using a different theme, but I could not get that running.


The current version can still be found at
https://people.debian.org/~holgerw/release-notes_sphinx
for all languages and in html|text|pdf
(or grab the results from Salsa's CI at
https://salsa.debian.org/holgerw/release-notes/-/pipelines
which builds fine now.)


Holger



-- 
Holger Wansing 
PGP-Fingerprint: 496A C6E8 1442 4B34 8508  3529 59F1 87CA 156E B076



Bug#932957: no longer build arch-dependent variants of r-n?

2023-06-21 Thread Paul Gevers

Hi Holger,

On 18-06-2023 14:32, Holger Wansing wrote:

We could just skip the last part of
the URL and point to
http://mirrors.kernel.org/debian/dists/bookworm/main/..
and that's it.


I agree.

Paul


OpenPGP_signature
Description: OpenPGP digital signature


Bug#932957: no longer build arch-dependent variants of r-n?

2023-06-18 Thread Holger Wansing
Hi,

Holger Wansing  wrote (Wed, 14 Jun 2023 21:50:18 +0200):
> Paul Gevers  wrote (Wed, 14 Jun 2023 21:19:00 +0200):
> > Also, on the topic of arch-specific builds, I not convinced it's worth a 
> > lot of effort. The amount of arch specific pieces is rather limited, so 
> > I wouldn't mind if we drop that altogether. Currently, we don't do a 
> > great service to people that need to support multiple architectures, 
> > because they need to *search* for the delta's, so I wouldn't be 
> > surprised if it is even better if we drop it.
> 
> From the technical side, I managed to get the arch-specific builds done in
> the meantime basically; so no problem anymore there - theoretically.
> 
> On the other side, I also thought about the arch-specific differences, and
> given they are only rather small, my assumption was, that it's maybe not worth
> it to differentiate between archs, when it comes to filtering out content
> of r-n depending on the architecture.
> But even if we leave that point out, there are some arch-dependent links like
> http://mirrors.kernel.org/debian/dists/bookworm/main/binary-amd64/...
> in chapter 4.3.1
> https://www.debian.org/releases/stable/amd64/release-notes/ch-upgrading.en.html#network
> 
> So, we still need to build the release-notes differentiated by archs
> (based on the current content).
> 
> 
> 
> However, that does not mean, we could not change our base rules, so that
> filtering out chapters based on architecture is no longer used.
> I would vote for this solution, yes.

Thinking a bit more about this, I wonder if we could indeed get rid of 
architecture-dependent r-n at all.

If all paragraphs/chapters are visible for all archs anyway, there are
only two situations where the arch shortname (amd64, i386 etc.) is used
in URLs. That is in
https://www.debian.org/releases/stable/amd64/release-notes/ch-upgrading.en.html#network
and
https://www.debian.org/releases/stable/amd64/release-notes/ch-upgrading.en.html#localmirror


   For example, suppose your closest Debian mirror is 
http://mirrors.kernel.org. 
   If you inspect that mirror with a web browser, you will notice that the main 
   directories are organized like this:

   http://mirrors.kernel.org/debian/dists/bookworm/main/binary-amd64/...
   http://mirrors.kernel.org/debian/dists/bookworm/contrib/binary-amd64/...

   To configure APT to use a given mirror, add a line like this (again, 
   assuming you are using main and contrib):

   deb http://mirrors.kernel.org/debian bookworm main contrib


So, the arch-dependent directories on the mirrors are mentioned here, but the
arch part is not really relevant here. We could just skip the last part of 
the URL and point to
http://mirrors.kernel.org/debian/dists/bookworm/main/..
and that's it. The same counts for the second occurrence of arch shortname.

That gives us the possibility, to simplify the whole r-n thing to only build 
one generic release-notes variant for all archs, in the different languages, 
and we are done.

How does that sound?


Holger



-- 
Holger Wansing 
PGP-Fingerprint: 496A C6E8 1442 4B34 8508  3529 59F1 87CA 156E B076