documentación de código php

[sci-fi]

hola,

alguien podría recomendarme

- algún enlace sobre "estándares" para escribir código php (ya he buscado varios, si les interesa los posteo, pero he encontrado que difieren mucho, y si alguien tiene experiencia con ellos le agradecería si me pudiera comentar algo sobre esto)

- alguna aplicación para realizar documentación de código php?

para lo de documentación, conozco "phpDoc" y "phpDocumentor", -si alguien conoce otro y me lo recomienda-, o si no cuál de estos dos me recomendarían, quien los conozca o haya usado? Yo optaría por "phpDocumentor" (phpdocu.sourceforge.net ), sin embargo me parece que es más usado phpDoc ((phpdoc.de ). Mi opción sería el primero pero quería saber cuál de estos dos me recomendarían

desde ya muchas gracias

saludos

[comun]

No hay varios "estandares" de php. La única documentación 100% fiable y perfecta de php es www.php.net
Lo demás son historias para no dormir. :-p

[Cluster]

Uno de los "standares" es PEAR:

http://pear.php.net

justamente PHPdoc genera documentación al estilo PEAR .. PHPdocumentar genera para PEAR y otros formatos creo .. Pero todas estas herramientas se basan en que estas programando en OOP y la OOP de por sí ya tiene sus reglas y standares para nombrar tus objetos, tus métodos y demas historias ..

Un saludo,

[sci-fi]

muchas gracias Cluster, era justo lo que precisaba
además PEAR es una librería open-source, excelente...

sí es para documentar unas clases..., por eso me refería solamente a la forma de escribir código y no al código en sí...

[comun]

No hay varios "estandares" de php. La única documentación 100% fiable y perfecta de php es www.php.net

lo dicho arriba... para escribir código orientado a OOP, sea open-source o no, te conviene (o hace falta si lo vas a hacer open-source) seguir unos estándares para escribir código (que no tiene que ver con el lenguaje, es solamente cómo escribirlo, usar tabulaciones o no, cómo escribir comentarios, etc, todo para hacer el código humanamente legible) a eso me refería con "estándares", si te interesa miralo siguiendo el link que pasó Cluster:

http://pear.php.net/manual/en/standards.php

cómo escribir comentarios es para generar documentación con phpDoc o phpDocumentor, luego, si las clases son open-source, te conviene seguir ciertas reglas para escribir el texto para que pueda verse bien en otros editores... yo había leído en un lado que había que usar tabulaciones para "sangrar" el código... luego que no había que hacer eso, sino utilizar solamente dos espacios... la forma de PEAR es con cuatro espacios... por eso no sabía que regla más convenía seguir... algo que me quedó en claro por el momento es que no hay que usar tabulaciones :)

bueno, muchas gracias y saludos

[Cluster]

Y a la hora de documentar un método por ejemplo .. hay q decir por ejemplo que parámetros acepta y su tipo (string, array, int .. etc) y los que devuelve (otro string, array, int .. etc ..) ..

Bueno .. eso lo describe bien en PEAR .. Y .. aunque se usen simples funciones "sueltas" (no en una classe) es bueno documentarlas así .. Como ejemplo solo hay q ver el manual de referencia del propio PHP o de cualquier lenguaje en el que se ven las descripciones de cada función ..

Un saludo,