Bug#609160: debian-policy: include DEP5
On Wed, Apr 06, 2011 at 01:00:22AM -0700, Russ Allbery wrote:
> Charles Plessy <plessy@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. <ballombe@debian.org>
Imagine a large red swirl here.
Reply to: