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

Re: Group policy draft



On Sun, 3 Feb 2008, Charles Plessy wrote:

Another improvement we should think about is wether we want to factorize
or federate part of our policy with other packaging groups in Debian. I
think that there are strong similarities, so keeping a collection of
documents with same content but different wordings will end up being
tedious, expecially for people like you David who are active in many
groups.

Sounds very reasonable.

Lastly, although TeX has many advantages, we have to think if we really
want to have it as a source language of choice for our policy:

- Many references documents in Debian are WML,
- many of our manpages are in DocBook, which is close to WML,
- there is a tool for converting wiki.d.o pages to DocBook.

As I said: I do not really like debiandoc-sgml but it was invented
for the purpose we are just needing it.

I have commited minor changes to the document (unrelated to the points I
just made). I was a bit lost in the .tex file, but I guest it is a
question of habits. Be it in .tex, .xml or wiki format, I propose that
the paragraphs are broken is short lines like in an email when syntax
permits.

Syntax permits in any case and I would be in favour of this.

In some cases it would bloat the diff, but in most cases, it
would help a lot to find the differences. Also, adding spaces between
paragraphs would help to navigate. Of course this kind of changes would
be better concentrated in one single commit.

Emacs has a cool feature to reformat LaTeX texts.  If nobody insists
I could do this.

Greetins from a snowy Japan,

Bah, it was more or less snowing all day yesterday.  If you want your
fellow Debian-Edu developers a safe trip home just hope that it stops
snowing until tomorrow evening ...

Kind regards from Northern Norway where dawn is currently making good
progress to become some kind of light :)

            Andreas.

--
http://fam-tille.de


Reply to: