control: retitle -1 Include multi-page HTML in package ^ see below for explanation Hello, On Tue, Aug 22 2017, Mattia Rizzolo wrote: > On Tue, Aug 22, 2017 at 12:10:36PM -0700, Sean Whitton wrote: >> - it would be nice to include the multi-page rendering in the package > > More than nice, please. I don't really deal with huge single-page > documents. Besides you wrote: >> The single page output is much more useful to casual readers wanting >> to look something up > I deem this completely subjective, please don't assume such assertion as > facts. Also, I don't consider myself a "causual reader" and when I want > to read something up I know what's the name of the paragrah, pick it > from the index and then head to the relevant, single page. Right, indeed, you're not a casual reader, and we would expect you to have the Debian package installed. I think the web version should be tailored for people coming from outside the project who don't know that such a package exists. For them, it's easier to have a single page. This is subjective but that doesn't preclude me making a judgement about what most people would prefer, based on my experience. >> - since we're publishing only the single-page version on >> www.debian.org, we need to rewrite the links > > Please do publish both. On Tue, Aug 22 2017, Guillem Jover wrote: > I guess there are two problems here, one is indeed completely losing > the multi-page rendering from the package. The other is the default > change in the web site. IMO the best solution, and what is customary, > is to present both (or more) rendering and let the user select: > > [HTML one-page] [HTML multi-page] [PDF] [EPUB] So you'd like https://www.debian.org/doc/debian-policy/ to be a menu? I think that those who want this should file a bug against www.debian.org. It's not really in our purview, since we don't maintain the script that maintains the /doc/ directory. Hence I'm retitling this bug to the part that is the policy editors' responsibility. -- Sean Whitton
Attachment:
signature.asc
Description: PGP signature