Estandar Documentacion PHP

COMO DOCUMENTAR EL CODIGO PHP

 * Que hace el sistema en su totalidad.
 * Cuantos módulos en total componen en el sistema.
 * Como se divide cada módulo.
 * Que hace cada parte del modulo dividido.
 * Parámetros de entrada o sobre que parámetros trabaja.
 * Con que html esta relacionado cada php.
 * Que base de datos utiliza.

Todo tiene que estar comentado antes del comienzo de la porción del código a documentar.

ESTANDARES DE NOMBRE DE VARIABLES
Todas las variables deben tener un nombre representativo y comenzar con $v.

Las variables que provienen de un formulario del html deben tener la forma $vf_nombre_formulario donde “nombre_formulario”. Las variables locales al código php: Si son el resultado de una consulta $vl_r_nombre_consuta, Si son enteras $vl_i_nombre_variable, Si son del tipo caracter $vl_c_nombre_variable, Sin son cadenas de caracteres $vl_s_nombre_variable, etc.

Agregado: Llamar a los campos del formulario como se llaman los campos de las tablas que estos representan (almenos para todo lo que sea ABM), no sé si es necesario usar ese tipo de nomenclatura (la que esta arriba) para todo lo que sea abm ya que es agregar cosas raras a tareas monótonas creo que con respetar el nombre de las tablas es suficiente.

Opinen a ver que les parece =).

ESTANDARES DE NOMBRES DE FUNCIONES
Deben comenzar con f_nombre_funcion, “nombre_funcion” deberá se un nombre representativo. Antes de la cabecera de la función debe quedar documentado que hace la función. Si la función tiene parámetros que éstos se pasen en lo posible en un formulario.

Agregado: Creo que esta demás poner la "f_" en el nombre de la función ya que en php no hay más que funciones tal vez en php5 la cosa cambia pero no apostaría.

[que bueno que esta el wiki]

COMO PASAR INFORMACION ENTRE HTML Y PHP
[estos son pensamientos más que aportes destruyan con cariño] Creo que es válido lo de nombrar las variables del formulario como sus representantes en las tablas, tal vez agregar lo que se pasan siempre por "post" y se capturan siempre con $_POST o $_GET, mmm evitar el uso de $_REQUEST a menos que sea necesario.