[TYPO3-50-general] General thoughts on namespaces and other ideas...

[Karsten Dambekalns]

Hi.

Johannes Reichardt wrote:
> - You really want to stick to XML editor?
> It looks choppy and i really do not understand why typo3 needs such 
> extra sausages for documentation. I personally would prefer a simply 
> wiki and some plugins that make a nice printable version. Please 
> enlighten me if there is a good reason for it.

Who cares for the looks? It works, whether it looks choppy or not! :)

The choice of DocBook is for the sake of semantics, plus you can 
generate loads of output formats. You can use whatever editor you like 
to edit it, no need to use XMLEditor - although it's the best tool we 
found for free. YMMV, of course.

There is a Wiki using DocBook internally, that might be an option, but I 
doubt it is as comfortable as a real validating XML editor ever can be. 
And we want fully valid, semantically rich markup.

If you need more reasons, search for background on the PHP guys using 
DocBook, I think I saw a nice explanation there once. Or search the 
TYPO3 documentation team newsgroup/mailing list archives, it was 
discussed there more than once.


Finally: Do you have any good reasons against using DocBook, aside from 
a choppy editor?


Regards,
Karsten

PS: As long as noone forks, we'll stick to DocBook.
-- 
Karsten Dambekalns
Gimme Five!
http://typo3.org/gimmefive