Re: [phpGroupWare-developers] manual

[Dave Hall]

On Sat, 2007-03-03 at 19:24 +0100, Sigurd Nes wrote:
> Hi all,
> Had a quick look at the manual at egw - they are using wiki for the
> manual - any reason for not trying this approach?
> For the link for addressbook they are using 'page=ManualAddressbook'.
> I would propose to also include the language - something like
> 'page=Manual<lang><manualitem>'

IMHO the wiki is not core functionality, but the manual is.  The problem
with using a wiki for such documentation is that all installs the need
the wiki installed in order for the manual to function.  Also our wiki
does not support ACLs and relies on people using (and understanding) the
wiki syntax.  I think the energy involved in mod'ing the wiki and manaul
apps to make this work would be better spent on writing the docs :)

The manuals and other docs should be ODT files as produced by OO.o2
Writer, AbiWord or Kwrite (or MS Office 2007 with a FOSS plugin).  This
is the most flexible way of maintaining and producing documentation.  It
also means that we can produce HTML and PDF.  We can even use XSLT to
convert the docs within phpgw to html.

Cheers

Dave
-- 
Dave Hall (aka skwashd)
API Coordinator
phpGroupWare
e address@hidden
w phpgroupware.org
j address@hidden
sip address@hidden
       _            ____                    __        __             
 _ __ | |__  _ __  / ___|_ __ ___  _   _ _ _\ \      / /_ _ _ __ ___ 
| '_ \| '_ \| '_ \| |  _| '__/ _ \| | | | '_ \ \ /\ / / _` | '__/ _ \
| |_) | | | | |_) | |_| | | | (_) | |_| | |_) \ V  V / (_| | | |  __/
| .__/|_| |_| .__/ \____|_|  \___/ \__,_| .__/ \_/\_/ \__,_|_|  \___|
|_|         |_|                         |_|Web based collaboration platform