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

Documentation co-ordinator's tasks

Since I have volunteered to take over the job of co-ordinator that has been
made vacant by Christian Schwarz's departure, I had better explain what I
think needs doing, so that you can all decide if you want me to do it.

1.  Move the DDP webpages onto a Debian machine (www.debian.org?); ask
    Christian to alter the page at his site to point to the new location.
    Add Havoc's Debian Tutorial to the pages.

2.  Move the documentation source onto a Debian machine.  Get from Ardo
    or have people resubmit any contributions they have already made
    and make sure that they are published.

3.  Make packages of the various manuals, as soon as they contain any
    reasonable amount of material.

4.  Arrange for people to be able to upload material and have it appear
    in the development version.

I'm not sure of the merits of using cvs to do this, because I think that
only the original author and the editor should be changing text.  Is it
possible to arrange cvs with limited permissions? [Each chapter owned by
its author, and in the documentation group; only the editors are group
members; all document sources have 664 permissions.] Ideally there
should be some kind of server that accepts submissions from authors,
incorporates them and runs a make of the HTML documentation, and (on
success) copies the HTML and SGML onto the website.

Any material submitted should either appear on the website or be rejected 
within a week.  Reasons for rejection would mainly be that the SGML fails
to generate output; other circumstances are conceivable but would (I hope)
never arise!

Any errors in content should become apparent if submissions are published.
If an author fails to correct an error quickly, I would expect to do it
myself, to avoid misleading readers.  If any dispute arises, it would
ultimately go to the Technical Committee.
Oliver Elphick                                Oliver.Elphick@lfix.co.uk
Isle of Wight                              http://www.lfix.co.uk/oliver
               PGP key from public servers; key ID 32B8FAA1
     "Love not the world, neither the things that are in 
      the world. If any man love the world, the love of the 
      Father is not in him."            I John 2:15 

To UNSUBSCRIBE, email to debian-doc-request@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org

Reply to: