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

Philipp Stucki <[email protected]> Sat, 11 Feb 2006 12:04:59 +0100
Newsgroups gmane.comp.cms.bitflux.general
Message-ID <[email protected]>
Adrian Nussbaum wrote:
>> That be great, but I think It should be available online and be
>> printable, not just "printable".

The PDF is automatically generated using XSL-FO and apache/fop from the 
XHTML-resources so the two versions are always in sync.

> does this mean, that it should be directly online - in your  
> docs.bitflux.org-style?

Keeping the thing like it is now would be great, because of the 
opportunity to generate the print version using the online one and thus 
having only one source.

Style is a question of stylesheets anyway, at least for the online 
version but for the print version as well, as long as it's generated 
with some tool like fop.

> i can understand that you'd prefer to have an online-version, too.  but 
> my clients mostly won't go there to have a look at it... so i  thought 
> of a really easy-to-understand-written manual - almost "for  dummies"... 

There are different versions of the manual for users, administrators and 
developers already. I think a dummy would fit into the user category. I 
don't think it makes sense to introduce another category.

The only real problem with the existing documentation is that it's 
hellishly outdated and therefore of no real use for anyone. This is 
currently a general problem with documentation for fluxcms which has to 
solved one day :)

Philipp

-- 
philipp stucki . bitflux GmbH . schoeneggstrasse 5 . CH-8004 zurich
[email protected]  .  phone +41 1 240 56 70 .  fax +41 1 240 56 71
http://www.bitflux.ch

-- 
bitflux-cms mailing list
[email protected]
http://lists.bitflux.ch/cgi-bin/listinfo/bitflux-cms