[gentoo-dev] Gentoo Documentation Considerations

Hi devs,

I have a few thoughts how we can handle the documentation for gentoo in
a way that we can use it for our
webpage and independently for a printable book.

At the moment we have two packages in app-doc

gentoo-web contains daniels gentoo-xsl style docs and stylesheets to
convert them to html
gentoo-doc contains docbook-sgml style docs which can be converted  with
dsssl stylesheets 
           to html,pdf,ps,man

Both packages contain the daniels install docs and petes Gentoo-HOWTO.

Now my plan.
We separate the articles from the build packages.
This means we create gentoo-install, gentoo-portage, gentoo-ebuild,
gentoo-man which contain
either gentoo-xsl or docbook style docs and those docs only get
installed to /usr/share/doc/gentoo/[guide|docbook].
Once daniel has finished his gentoo->html xsl stylesheet, I create a
gentoo->docbook xsl-sheet.

gentoo-web now can contain an global xml file which is generated dynamic
from the content of 
	   /usr/share/doc/gentoo/guide. It generates the website-content from
this global file.

gentoo-doc must convert the guide-style files to docbook. After that it
generates a global docbook book
           file and creates prinatble output.

This way we have our docs allways up to date on the web and as a book.

achim~