Re: [PHP-DOC] Documenting coding standards

2006-10-16 Thread Friedhelm Betz

Hi,

Philip Olson wrote:

[...]

We could link to PEAR. In the docs we use the PEAR coding standard for 
examples. We should not duplicate the infos from PEAR, imho.


How about having the tutorial briefly talk about it (why it's good to 
do), and link to the PEAR coding standard.


Fine with me. Talking about coding standards in general and *briefly*, 
linking to PEAR is fine with me ;-)


And to go one step further: talking about documenting sourcecode and 
link to phpdocumentor?


Seems a good idea to me ;-)

Maybe in "Hints and Tips" ...

Friedhelm


Re: [PHP-DOC] Documenting coding standards

2006-10-16 Thread Philip Olson


On Oct 15, 2006, at 7:14 PM, Friedhelm Betz wrote:


Hi,

Etienne Kneuss wrote:

Hi,
Currently, there is no official coding standards documented on  
php.net. Because of that, the coding standards of PEAR are often  
referenced in discussions.
It may be useful to document some coding standards: indenting,  
whitespaces, directly on php.net, giving beginners rules/advices  
to code in a way that looks nice.


[...]


What do you think ?


We could link to PEAR. In the docs we use the PEAR coding standard  
for examples. We should not duplicate the infos from PEAR, imho.


How about having the tutorial briefly talk about it (why it's good to  
do), and link to the PEAR coding standard.


Regards,
Philip


Re: [PHP-DOC] Documenting coding standards

2006-10-15 Thread Friedhelm Betz

Hi,

Etienne Kneuss wrote:

Hi,

Currently, there is no official coding standards documented on php.net. 
Because of that, the coding standards of PEAR are often referenced in 
discussions.
It may be useful to document some coding standards: indenting, 
whitespaces, directly on php.net, giving beginners rules/advices to code 
in a way that looks nice.




[...]



What do you think ?


We could link to PEAR. In the docs we use the PEAR coding standard for 
examples. We should not duplicate the infos from PEAR, imho.


Friedhelm


[PHP-DOC] Documenting coding standards

2006-10-15 Thread Etienne Kneuss

Hi,

Currently, there is no official coding standards documented on php.net. 
Because of that, the coding standards of PEAR are often referenced in 
discussions.
It may be useful to document some coding standards: indenting, 
whitespaces, directly on php.net, giving beginners rules/advices to code 
in a way that looks nice.


Now, I'm afraid it can't be done from a completely objective point of 
view and depends on tastes. Maybe a vote ?


What do you think ?

-E

--
Etienne Kneuss

http://www.colder.ch/
[EMAIL PROTECTED]