AW: [wp-docs] DocBook, anyone?

[Christian Balzer]

Hi.
I was just scanning your e-mails, and I noticed you started a discussion on
a DocBook. (Whatever that is.)
I think new ideas are great, but could we, maybe, first finish the actual
documentation? ;)
There are lots of useful pages in the wiki, but all of them have to be
revised and ported to the official website.
And before you make anything out of them, we have to (I know I'm repeating
myself) come up with a license, I think.
Because you cannot use other peoples work if they didn't agree to, can you?
And as I already mentioned, I'm not able to help, because I'm too young, too
busy and too european... ;o)
(Which means I have no idea about US laws or the necessary vocabulary.)
But I think that kind of a document is _very_ important for our work, and we
should first come up with one, even if it's only, like, 5 lines long. (The
shorter the better. Take CC as an example. And remember KISS. We want a
readable documentation, not a "243 pages (single-spaced and double-sided)"
kind of technical manual full of gibberish which nobody is going to read, do
we? ;o)
Hope I didn't offend anyone.
Christian 
 

> -----Ursprüngliche Nachricht-----
> Von: docs-bounces at wordpress.org 
> [mailto:docs-bounces at wordpress.org] Im Auftrag von Ryan J. Markel
> Gesendet: Donnerstag, 15. April 2004 17:45
> An: Mailing list for discussing and developing WordPress 
> documentation.
> Betreff: [wp-docs] DocBook, anyone?
> 
> All right.
> 
> I'm not sure about the wisdom of going ahead and proposing 
> this, but I would like to get some feedback about collating 
> the documentation project for WP into a single, unified DocBook.
> 
> I am slowly going about the learning process for creating and 
> parsing an XML-based DocBook document, but it's pretty slow 
> at this point - the learning curve is a little greater than I 
> was led to believe by people I know who've used it.
> 
> Is there anyone here who has experience with DocBook as a 
> DTD?  Or has this been brought up before and ended up torpedoed?
> 
> DocBook has a lot going for it in the organization of 
> information category, as well as ease-of-reading.  It's 
> pretty straightforward, collates the docs into a nice 
> hierarchy if written properly, and isn't as circular as the 
> wiki - though I I realize this would leave the wiki in a 
> weird sort of limbo.
> 
> It's my suggestion as a source of official documentation.
> 
> "Shots fired!  Shots fired!"
> 
> --markel
> markel at strategema.net
> 
> 
> _______________________________________________
> docs mailing list
> docs at wordpress.org
> http://wordpress.org/mailman/listinfo/docs_wordpress.org