Re: Documentation co-ordinator's tasks
Hi,
First of all, I support you as the DDP co-ordinator.
Second, we should also redistribute the "maintainership" of some of
the manuals. What I mean is that documents which are only/still in
the planning stage should be owned by e.g. you or the DDP as a whole
unless someone takes it up. This would also make clear to others
who is actively doing what and whom to contact. When I took over the
debiandoc-sgml package last January I already wanted to hand over the
"maintainership" of some of the manuals, but Christian persuede me to
"hang on". Since then I've mainly been working on that package and
did not spend any time on the manuals. This is a bad situation which
I regret.
In other words, I think my main contribution to the DDP should be the
maintenance of the debiandoc-sgml package. There's quite some work to
do on this package and I would rather spend my time on one or two
tasks doing them right than spreading it over a lot not doing a good
job on either of those.
So, I'm orphaning all the manuals with my name as maintainer. This
includes the meta manual, user's manual, the sysadmin manual, the
netadmin manual, the dictionary, and the book suggestions list. The
user's manual should be renamed to reference guide. For the book
suggestions list and the dictionary Christian had the idea of making
them web-based in the sense that anybody could submit new entries for
them, provide updates of existing entries, etc. We already talked
about some design issues, but it got never beyond that point. I hope
all of them get suitable parents. :-)
Thanks,
Ardo
"Oliver Elphick" <olly@lfix.co.uk> writes:
> 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
--
Ardo van Rangelrooij
home email: ardo.van.rangelrooij@tip.nl, ardo@debian.org
home page: http://www.tip.nl/users/ardo.van.rangelrooij
PGP fp: 3B 1F 21 72 00 5C 3A 73 7F 72 DF D9 90 78 47 F9
--
To UNSUBSCRIBE, email to debian-doc-request@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org
Reply to: