RE: [Phpgroupware-developers] PHPDocs for head

[Kai Hofmann]

Hi Dave (and all others),

> >  1. Skel
> 
> I think we need a better skel/example application for 18.  There is a
> chance that the current email app may be relegated to unsupported.

Correct also I am thinking skel should be LGPL that will help start a
commercial product.
Docs already commited

> >  2. phpgroupware
> 
> The portal box code needs to change for 18 IMHO.  Maintained by
> coordination team.

Docs already commited

> >  3. setup
> 
> fips has indicated that he wants to rewrite it.

Docs already commited

> >  4. preferences
> 
> ceb's app so check dev plans with her

Docs partly already commited
This is independend of future development.
Its more important that the docs go with new developed code.

> >  5. admin
> 
> ceb's app so check dev plans with her

Docs already commited

> >  6. manual
> 
> ceb's app so check dev plans with her

Docs already commited

> >  8. pbwebmaui
> 
> Would be good, some people can make it work with something other than
> courier

Webmaui has already docs I have done in the past - will only check
if they are up to date and bugfree.

> >  9. adressbook
> 
> lex and jarg's app so check dev plans with her

no problem.

> > 10. sync
> > 
> > The plan ist to make these modules all go through 
> phpdocumentor without
> > errors
> > and then complete the documentation for developers.
> > Commits will go directly into head.
> 
> They will need to go onto the tracker if they are maintained,
> maintainers can advise otherwise.

To complicated and error prone - under these situation I will stop
creating docs. Best would be when the maintainers will tell me that they
don't want docs - that was the idea of this mail (see below).

> > If someone don't like that please inform me in the next days.
> > 
> > The phpdoc work on the api has been stopped for known reasons.
> 
> What would they be?

No more api commit rights
without direct commit rights - creating docs would be not practicable.

Also a lot of bugfixes could be, because creating docs is the same as doing
a
code review.

Greetings

   Kai

-- 
*****    Open Source und Linux im professionellen Einsatz    *****
**  komplexe Mailserver, Groupware, Office: sprechen Sie uns an **
Dipl.-Inform. Kai Hofmann                    Team Softwarelösungen
pro|business AG, EXPO Plaza 1 (Deutscher Pavillon), 30539 Hannover
E-Mail: address@hidden,   Tel.: 0511/60066-332, Fax: -355
WWW: http://www.probusiness.de/