Guía de estilo autoría ficheros PHP

[geofran80]

Buenos días,

Me ha surgido una pregunta ya que he visto que hay quienes siguen unos estándares y otros usuarios que documentan de forma aleatoria.

Mi pregunta es, ¿cómo se documenta un fichero de PHP en cuanto a la autoría, licencia, etc.?

He visto comentarios multilineas pero en algunos casos varían, en otros usa @ al estilo phpdocumentor, etc.

Si alguien puede asesorarme sobre la guía de estilo que se debería seguir.

Gracias de antemano.

Saludos cordiales.

[quinqui]

Holas, geofran80.

Sólo para no dejar tu post sin respuesta, creo que lo que preguntas es decisión personal, o si estás en un entorno de trabajo de equipo, pues seguir el que te ordenen tus jefes. En mi caso personal, trato de usar los famosos @ por si alguna vez uso el phpdocumentor xD

Habría que esperar la opinión que tienen los otros usuarios sobre este tema...

Saludos!

[geofran80]

Muchas gracias quinqui, el tema es que es para diseñar algunos módulos para diversas aplicaciones, y podría trabajar gente de muy diversos proyectos con lo cual quería estandarizar un poco.

Gracias nuevamente.

Saludos cordiales.
Francisco J.