[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#877337: www.debian.org: Switch back to single page version of Policy Manual



On Sat, 30 Sep 2017 09:33:52 -0700 Sean Whitton wrote:

> We (the active Policy Team members) think that the single page version
> is more suitable for Debian's web mirrors.  This is because it is more
> useful for newcomers: with the single page version, it is possible to
> use your browser's search function to search across the entire document.
> More experienced users, who want the multi-page version, probably have
> the debian-policy package installed locally.

I wonder if we could accommodate both categories of Debian Policy
readers instead of dropping support for more experienced readers?

I propose to do it by placing both versions of the document into the
same directory and then setting the DocumentIndex Apache configuration
option to prefer the single page document over the multi-page one.

The advantage of this is that we accommodate folks who prefer the
existing multi-page document and no existing URL will break but that by
default new users will get the single-page version.

The only problem with this is #877573 but that also affects offline
readers of Debian Policy anyway so it needs to be fixed anyway.

I have verified with diffoscope that the _static and _images
directories are identical between the two documents.

If there are no objections to this then I can do the changes needed.

-- 
bye,
pabs

https://wiki.debian.org/PaulWise

Attachment: signature.asc
Description: This is a digitally signed message part


Reply to: