[drupal-docs] On docbooks

[Boris Mann]

On 21-Apr-05, at 9:14 AM, Anisa wrote:

> OK, so, I probably wouldn't even be able to make a hello world module, 
> so I do not know the technical issues involved, but if ya'll are so 
> enamored with DocBooks, what about something like this:
>
> http://doc-book.sourceforge.net/homepage/
>
> A demo of what it looks like is here:
>
> http://www.soft.inima.al/book/
>
> Pros, cons, this stuff sucks?  The features seem pretty nice, but I've 
> been fooled by pretty feature lists before (cpg nuke!).  I'd install 
> it, but you  know...  shared hosting and all that.  ^.^

Oooh. Nice find, Anisa. Meets our wiki requirement for easy editing by 
anyone as well as DocBook requirements. This might be a really good 
target to have up at docs.drupal.org...

Richard, want to give a try installing this on Steele?

>  I view the process of building handbook 2 in this manner:
>  1. Decide the general organization of content. 
> http://dev.bryght.com/t/wiki/HandbookVersionTwo
>  2. Establish serious, detailed, style guides, as Djun Kim suggested.  
> http://drupal.org/node/15289
>  3. Establish a work flow.  For example, wiki > handbook > print 
> format.
>  4. Review old documentation and rewrite, and reorganize based on new 
> guidelines.
>  5. Voila, beauty.

+1 on this as well. I think we're pretty close to consensus on the top 
level sections.

--
Boris Mann
http://www.bryght.com
Vancouver 778-896-2747 / San Francisco 415-367-3595
IM boris_mann at jabber.org / SKYPE borismann