Re: [Phpgroupware-developers] phpgroupware documentation

[Brian Johnson]

I still prefer the browser based wiki (or other system) that permits
simultaneous group editing (although not on the same page at the same time)
and can be organized in a way that permits the export into other formats (like
a docbook manual) or perhaps have it available in a number of formats at once.

I need zero additional software and it has a very small learning curve

It can also be searched

A public wiki is easy to install but it requires someone with write access to
our site to set it up




Sigurd Nes (address@hidden) wrote:
>
> Thomas Viehmann wrote:
> > Hi.
> >
> > Brian Johnson (address@hidden) wrote:
> >
> >>When can we have a system implemented that will encourage (or even allow)
> >>user participation in developing docs?
> >>2. a second wiki with public write access for developing docs that would
> >>be ported to the docs.phpgroupware.org one by hand (occasionally)
> >
> > Good thought.
> > Maybe even a system that would allow user comments on the official pages.
> > (With a show only official option etc.) I've seen this e.g. for the Zope 
> > book on
> > zope.org (yeah, that's some other equipe that is more open source than free
> > software, sorry), and AFAIK you can decide whether to allow anonymous 
> > additions or
> > only registered users.
> > That way, you'd get corrections and annotations more or less in the right 
> > place
> > (advantage for the project) and save users of checking both official and 
> > inofficial
> > documentation (advantage for the users).
> > Unfortunately, I'm totally incompetent w.r.t. software they use, but I've 
> > observed
> > that I often find that convenient.
> >
> > Another point about Documentation:
> > Something I'd personally like in the doc directories on CVS would be a 
> > short file
> > giving a very short summary of the apps, possibly along with the maintainer
> > information, ideally in a RFC822-header-style file.
> > That could be used to give you as application maintainers a more direct 
> > handle on
> > the description of the apps, e.g. in the rpm, debian descriptions as well 
> > as a
> > detailed list of supported apps on the web page.
> >
> > Cheers
> >
> > T.
> >
> How about adopting the making of the phpmanual as Docbook/XML - which
> allows the documentation released as pdf,rtf,html,chm...(with user-notes).
>
> The phpdoc can be downloaded from cvs:
>
> Log in to the PHP CVS server. use the anonymous user cvsread as the
> username, and use phpfi as the password:
> cvs -d :pserver:address@hidden:/repository login
> cvs -d :pserver:address@hidden:/repository checkout phpdoc
>
> To set up a SGML/XML editing and publishing system for Linux is trivial.
> For windows - have a look at
> http://ourworld.compuserve.com/homepages/hoenicka_markus/ntsgml.html
>
> Sigurd
>
>
> _______________________________________________
> Phpgroupware-developers mailing list
> address@hidden
> http://mail.gnu.org/mailman/listinfo/phpgroupware-developers
>