On Wed, Apr 06, 2011 at 01:00:22AM -0700, Russ Allbery wrote: > Charles Plessy <ple...@debian.org> writes: > > > Pong :) > > > Here is DEP-5 in DocBook format, and the changes needed to the > > debian-policy package to build it in HTML and text formats. I have > > followed the same way as the Debconf spec. In the long term, there is > > probably a smarter way to do, but for the moment, it will allow people > > to inspect the converted version of the DEP. > > > DocBook does not allow simple paragraphs to follow a section. Therefore, > > I had to move a couple of things (see below). Also, the current style > > uses a lot of bullet points, which nead heavy XML tagging, and do not > > match the style of the Policy in general. I changed this to a more > > paragraph-oriented style, but I can easily revert it. > > > There are two issues that I did not have time to investigate. The first > > is that the HTML file does not declare that it is encoded in UTF-8, and > > the second is that the sections are not numbered. > > Okay, I've installed this in the Policy Git repository, because I think > it's a good basis for additional work and I don't see a good reason to > wait. However, I think it could definitely use additional proofreading, > and I'd really like Lars to review the results as well. > > My inclination is to include it in the next debian-policy package upload, > but (since that's happening tomorrow, not giving people much time), remove > the reference to it in Policy proper for right now and not make a big deal > out of the fact that it's there. That includes not putting it up on the > web site yet. Then, we'll use the next bit for further review and any > fixes to formatting, wording, markup, and so forth, and we'll add in the > formal linkage and the rest for 3.9.3 (which I intend to not take nearly > as long as 3.9.2 did, and I see Bill is of the same opinion). > > Does this sound reasonable to everyone?
This is a great idea. Having a fixed reference version make any further review and formatting much easier than a constently evolving text. Cheers, -- Bill. <ballo...@debian.org> Imagine a large red swirl here. -- To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org
