Re: Is there a need for a printable Flux-CMS-User-Documentation?

Hi

docbook is fine, but I think kind of overkill for this project and hard
to get into for newcomers. We shouldn't increase the barrier for writing
docs :) XHTML is just fine IMHO and we already have an output for PDF
(xsl-fo) for the whole documentation.

If anyone has compeling arguments, why docbook is better than xhtml
(with collections for more structures), then I may reconsider it. But
right now, I see no real advantages of using it over xhtml (for what we
actually need)

But at the end, it's the content that matters and which is the big
problem, not the technical form of it :)

chregu



On 13.2.2006 9:28 Uhr, qMax wrote:
> Saturday, February 11, 2006, 4:50:19 PM, Adrian Nussbaum wrote:
> 
> 
>>>That be great, but I think It should be available online and be
>>>printable, not just "printable".
> 
> AN> does this mean, that it should be directly online - in your  
> AN> docs.bitflux.org-style?
> AN> i can understand that you'd prefer to have an online-version, too.
> AN> but my clients mostly won't go there to have a look at it... so i  
> AN> thought of a really easy-to-understand-written manual - almost "for  
> AN> dummies"... but i'm not shure about that. maybe i could create out of
> AN> the (updated) online-version a nice printed one as well...
> AN> or should i create some pages (pdf) as draft so we can discuss about
> AN> this try? (the online version could maybe be updated out of this  
> AN> thing...?)
> 
> I'd suggest using docbook xml format (http://docbook.sourceforge.net/)
> as a source of such documentation, and then apply Norman Walsh xslt stylesheets
> (http://wiki.docbook.org/topic/DocBookXslStylesheets)
> to convert it to either xsl-fo, html, chunked html, windows help, or whatever.
> 
> Docbook is very convenient and was designed to write documentation of
> any kind, especially technical.
> And there're some xml editors featuring wysiwyg mode for docbook.
> (xmlMind, Oxygen as an instance)
> 

-- 
christian stocker | Bitflux GmbH | schoeneggstrasse 5 | ch-8004 zurich
phone +41 44 240 56 70 | mobile +41 76 561 88 60 | fax +41 1 240 56 71
http://www.bitflux.ch | [email protected] |  GPG 0x5CE1DECB
-- 
bitflux-cms mailing list
[email protected]
http://lists.bitflux.ch/cgi-bin/listinfo/bitflux-cms