[Phpgroupware-developers] Proposal execution speed vs. documentation and code maintenance

[Kai Hofmann]

I would like to discusse the problem of execution speed versus
code maintenance/documentation here.

In the past you tried to optimize execution speed by using tabs instead of
spaces for code formatting (see coding style guide), avoiding comments etc.
On the other hand code should always be readable/maintainable,
understandable
and extendable. (for example I proposed to use phpDocumentor).

>From my point of view a documented and maintainable code is much more
important
than execution speed, because execution speed can be reached by using
things like phpAccelerator which precompiles code automatically rmeoving
comments and formatting.
But I respect your point that a lot of people don't have the php
installation under
their control and so they can not use things like an accelerator.

So I would suggest another solution:

1) keeping the source code in the cvs documented and maintanable
2) for release archives checkout the actual cvs and then strip comments,
spaces etc. from it.
   (there are tools freely available to do this). 
   This code is not maintainable any longer, but fast instead.

as a result you have documented, maintainable code for developers in the cvs
(everyone who develops
on phpgroupware is able to install a phpaccelerator on its own developing
machine).
On the other hand you have fast code without comments etc. for productive
usage.

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/