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

Paul Wise <[email protected]>
Newsgroups gmane.linux.debian.devel.www
Organization Debian
Message-ID <1506997406.13760.52.camel__36380.9415408925$1506997640$gmane$org@debian.org>
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
signature.asc (application/pgp-signature, 833 B)
-----BEGIN PGP SIGNATURE-----

iQIzBAABCgAdFiEEYQsotVz8/kXqG1Y7MRa6Xp/6aaMFAlnS9J4ACgkQMRa6Xp/6
aaMQqRAAoiR/9qCikx5k8zSVthP/NcI6wo2yttPGnzO89aFx2eBWur8sUcKQl0Z9
jN1BF/pvrTz2TB8uvLYmwhuyHAmFNNPbE4EZeQ8623qCQzqzPAarn/VwjrZlhUL0
2I4Y05J8xn2cQI5Ge1zqKhJYsNLJHZHrNYJYHb7iPaNskkp5diFWI0DaVfKLJSAO
EDrpxNgVaRX2/wyvy6HbHCWtiyHgLuTjYG79IsqS4ORUP3bAa2UtBAyNPjB3sCW1
UXNnVdfu429FL6qcN5uJsqic4n0uyxsCyMqv+suhD0YbkgASKupX/wrotIfgstL9
Pk6aP+BHNcM8mWeYkz+YDyQ2ow9CA1fbX7QLnZrRNR4He5mtI6Vh89LtAAHwobPS
QCVEJ601GAdA2ZkZpyThemGxiaN3ZYW/QORxtV7/dC5CMofLLQ6CoQJk86moF/oL
DXfPrRpV2Yfyub8YCNnRih46krAWp6f6uxEyvNPT+qwjHTnq3Sf0UjrN44/vzOgw
Rlg1nj1HzAkoKXakyAwuKTnVftjlDOs09Tm87CHA7VECE6ThIZDGRmJP4r/AXx5b
EHqnQOgpl5FgJIrYbrstWqJUoOcDh2zI9SmJP0J7CsO6e/kDseNmDut8xdB4WxRS
VR2JqXuAafeaGwNKf5To5W1DXnlEuJxnK5FEhPB3meyxkxePT/4=
=8xJa
-----END PGP SIGNATURE-----
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.