Programación – Escribe tu código organizadamente

El orden a la hora de escribir código viene a ser para la programación lo que la posición de los jugadores en un partido de fútbol. Mientras más organizados estén, mejor. Con lo anterior en mente, me permito sugerir lo que a mí y otros programadores nos ha funcionado, y seguramente podrás también aplicar: Code Indenting.

Antes de continuar, sólo mencionar que estos consejos están pensados para los que van comenzando, ya que no es hasta participar en proyectos más grandes cuando se toma en cuenta el orden del código. Tanto para ti, como para los demás miembros el equipo.

Aplicar el Code Indenting no es complicado, sólo requiere que el programador esté muy atento a lo que va escribiendo, y tras cada “cambio de jerarquía”, dar a la siguiente línea de código un espacio mayor a la anterior, de tal forma que se visualice que el código se va adentrando, y que forma parte directamente de las líneas que estén un espacio menos adentro que ella misma. Bastante complicado de explicar con palabras, pero tómese como referencia el siguiente ejemplo, seguramente lo podrás asimilar mejor:

if ($result = $mysqli->store_result()) 
{ 
    while ($row = $result->fetch_assoc()) //SE RECORREN TODOS LOS RESULTADOS
    {
        echo 'utf8_encode($row['algo_id']) ';
    } //FIN DE WHILE
} //FIN DE IF

Mientras que un código desorganizado se vería como el siguiente:

if ($result = $mysqli->store_result())
{while ($row = $result->fetch_assoc())
{echo 'utf8_encode($row['algo_id']) ';}}

La pregunta ahora es, ¿Cuál se te hace más sencillo de comprender? Según tu respuesta, será la técnica que debas utilizar. Como mencionaba, a mi me sirve más en el que se utilizó Code Indenting, porque puedo visualmente comprender más rápido lo que sucede en esa parte del código. Pero no es regla, ni mucho menos una ley, pero sí una buena práctica.

Y como detalle extra, los comentarios son sumamente importante, por lo que también sería bueno que comenzaras a comentar tu código. A la larga tu mismo lo agradecerás, porque uno tiende a olvidar para que funcionaba cierta sección de código :P