On Mon, Dec 29, 2003 at 06:55:50PM +0100, Bart Lauwers wrote: [...] > Anyway we've got lots of docs but were lacking a good taxonomy for them, > do we have any librarians helping the docs team? (cc'ing doc to get a reply > about this)
Librarians? Not that I know off... What do you mean with taxonomy?
> So let me rephrase that portage docs need to be complete and up to date at
> all times (at least an english version, devs should know enough english).
> Linking the documentation to the code is the only way I can see this happen.
Creating documentation automatically always reduces the readability of the
documentation. It all depends on who's the intended reader. If it is a
developer (and *only* a developer) then creating documentation automatically
might be suggesteable (although not official as there is no QA on it - don't
dare send me bugreports on automatically created documentation :)
If it also involves users, then sorry, I don't think this is a good idea.
Wkr,
Sven Vermeulen
--
^__^ And Larry saw that it was Good.
(oo) Sven Vermeulen
(__) http://www.gentoo.org Documentation & PR
pgpjj7UJ8sugk.pgp
Description: PGP signature
