Re: [RFP] A more maneagable way to include documentation
On Mon, Mar 20, 2000 at 07:40:00PM +0100, Josip Rodin wrote:
>
> That I think has been the whole problem: how to move only the finished
> stuff to /doc/ddp/, without the development stuff. I think we should edit
> the DDP web pages once we move them to the website so that all references
> to unfinished stuff are removed.
>
> Perhaps the stuff in development should be put on (and linked to) another
> machine so that it doesn't get mirrored? We have several machines to pick
> from.
>
Actually, since the docs aren't that big, it wouldn't matter if they
get mirrored. What is more important is that we only link the stable
documents. The authors of the documents also need to create tags
for important sections of their document so links can be made to
those sections in a robust way. Additionally, The tags need to be
documented.
Two other items. First, the contact address should be clearly marked at
the beggining of all docs. We need to make it easy for people to submit
feedback. Second, all documents should include version numbers. This is
especially important since they are being distributed in multiple
places (web, archive /doc section (both ftp and on CDs), and as packages).
--
James (Jay) Treacy
treacy@debian.org
Reply to: