Bug#877337: single-page html of debian-policy to be revived?

Sean Whitton <[email protected]> Sun, 14 Apr 2024 20:43:51 +0800

Newsgroups	gmane.linux.debian.devel.www
Message-ID	<875xwk2jy0.fsf__5191.55472736514$1713099277$gmane$org@melete.silentflame.com>

Hello,

On Sun 14 Apr 2024 at 01:57pm +02, Holger Wansing wrote:

> 1.
> Currently, the package does not ship this version. So this would have to
> be re-added there.

The changelog for 4.2.0.0 says

  * Stop installing policy-1.html because Sphinx's singlehtml output is
    too buggy at present (Closes: #873456, #876075, #879048).
    See also #877367.  Thanks to Paul Wise for switching the web mirrors
    away from policy-1.html.

I had forgotten about this.  It seems that the first thing to do would
be to determine if the issues discussed in those bugs still exist.

> 2.
> There are pro's and con's for both the single-page and multi-page variants.
> Thus the only possible way IMO is to ship both via www.d.o.
> The developers-refererence also ships both already, so it would be consistent
> there.

... but if dev-ref is already shipping both, maybe singlepage is indeed
usable these days ...

> Could the Policy Editors team check, if everything is fine now, and if
> this should be published again?
> At least there is still an issue with the footnotes, there are 16 occurrences
> of #id1 for example... (search for "[1]" in policy-1.html).

Hrm.  That seems like a pretty serious problem :\

Holger L., did you know about this issue?
Did you decide it was worth publishing anyway?

-- 
Sean Whitton

signature.asc (application/pgp-signature, 869 B)