AW: [Mapbender-dev] Reminder: Code Conventions

[Christoph Baudson (WhereGroup)]

Hello again,

The conventions I came up with is what I got out of this book

Code Complete, Second Edition (Steve McConnell)

See http://www.techbookreport.com/tbr0126.html for more information.

I tried to compress the huge amount of information to a digestible size, 
with rules that are easy to understand and fast to learn.

As I said before, it is a first draft, so if anybody has more sources, 
please add reviews to the wiki page and share your opinion on this list.

Cheers,

Christoph



Samson, Marko schrieb:
> Hi,
> 
> I think, that the code conventions are a good thing to make developing more efficient and productive, after a therm of adjustment to the conventions. (@Cristoph:btw. are this standard php conventions? where did you get them from, or did you develop your own conventions?)
> 
> But my opinion to comments is like Marcs. I don't think, that comments would be a great performance or filesize problem. (or did you have any problems by files, inflated by comments, in the past?)
> Surely, there is no reason to comment every row. But I think, that a short description of a function (needless to say, that not every set and get function has to be commented), perhaps with some special problems or conditions and some special vars, would increase the productivity and double developing and uncontrolled function-groth in every module.
> 
> As the Code Conventions say: performance is not a good reason to avoid commenting
> 
> 
> Gruß,
> Marko
> 
> 
> Marko Samson
> Landesbetrieb Wald und Holz NRW
> GIS-Anwendungsentwicklung
> Referat I-5
> Albrecht-Thaer-Straße 34
> 48147 Münster
> 
> 
> Achtung, neue Telefonnummer!
> Tel.: 0251/91797 - 169
> Mail: marko.samson at wald-und-holz.nrw.de
>  
>