Página 4
Traducciones y Terminología
Página 5
Índice
Ver este artículo en español 
Página 6
About interface abuse, DI-infestation and interfaceitis

Manual de Estilo de Programación

Alexander Hristov

 

03 - Diciembre - 2007

En (casi) todos los proyectos en los que he dirigido desde hace más de 10 años, siempre me ha obsesionado el tema de la calidad del desarrollo, y dada mi vena científica, siempre he buscado cosas que de forma demostrable (a diferencia de "opinable") condujesen a una mayor calidad en el software. Por ello siempre me ha interesado todo lo relacionado con los sistemas de aseguramiento de la calidad o las métricas de software y los sistemas de predicción de defectos.

Una de las piezas claves de esta "obsesión" es un manual de buenas prácticas a nivel de codificación - una especie de miniguiía de unas 50 páginas que intenta destilar de forma breve y escueta directrices básicas de programación que pueden no ser evidentes para programadores con poca experiencia o con poco tiempo para estar al día en temas de calidad de software.

Hasta ahora, nunca se me había ocurrido que este tipo de guías pudieran interesar a nadie salvo a mí. Uno siempre supone que cualquier empresa medianamente seria dispone de estándares para homogeneizar la forma de construir software y que probablemente esos estándares sean mucho más precisos y apropiados que cualquier guía que haya podido humildemente crear yo. Sin embargo, de forma sistemática mi experiencia en diferentes sitios siempre ha sido la contraria. Salvo en el caso del CPD de Banesto, la inexistencia de estándares de codificación era notoria y dolorosa, llevando a tener que depurar una y otra vez los mismos errores causados por las mismas malas prácticas.

Y no se trataba de que los responsables no supiesen dónde estaban los problemas, sino del mal endémico de siempre en el sector - la falta de tiempo. Tiempo para sistematizar el conjunto de buenas prácticas, tiempo para expresarlo en forma de estándar, tiempo para implantarlo y tiempo para llevar un seguimiento del mismo.

Hace un par de meses, me topé accidentalmente con el blog de un antiguo compañero de trabajo - Nicolás Aragón (alias "NicoNico" ), en el que relataba su experiencia en diferentes empresas y - refiriéndose entre otras cosas a este manual - comentaba básicamente la misma situación. (Parece ser que el post original ha desaparecido, pero todavía está en la cache de Google)

Así que dije - ¡qué demonios!, por qué no darle un repasito y publicarlo por si a alguien le puede servir de ayuda. Y aquí está - la versión más reciente, con licencia Creative Commons. ´

Este manual ha tenido más de 5000 descargas desde la publicación. A todos los interesados - gracias, y espero vuestras sugerencias y críticas. En breve - la siguiente edición

 

Estilo de Programación Manual de Estilo de Programación, Versión 9.01 de 24 de Diciembre de 2007 [PDF]

 

 

 

Comentarios

12/11/2009 a las 02:12 Enviado por Diegof
Muy buen documento, felicitaciones, ademas de adquirir buenas practicas en la codificacion al momento de desarrollar da buenas pautas al momento de levantamiento de requerimientos, gracias por el aporte
08/07/2009 a las 03:51 Enviado por jean
disculpa ¿es lo mismo q estandares de programacion.... q estilos de progrmacion? y quisiera saber.. sobre el estandar kamel...
31/05/2009 a las 07:08 Enviado por Ismael
Excelente! Es bueno contar con un documento que nos permita implementar buenas practicas en la codificacion.
26/05/2009 a las 16:09 Enviado por anonymous
Gracias por el pdf me parece muy interesante lo comenzare a leer
13/03/2009 a las 13:54 Enviado por Mery
por favor necesito un manual de estilos de progrtamacion, sin es para programar bajo PHP y javascript muchom mejor...Gracias y espero me complascan a mi y muchos que se lo necesitan.
09/02/2009 a las 03:04 Enviado por edgar
genial... hombre personas como tu son pocos que comparten sus conocimientos, gracias por este valioso aporte para otras personas que todavia quieren aprender. ¡gracias!.
03/09/2008 a las 17:18 Enviado por Octavio
Felicidades por un documento muy bien redactado y documentado. Un comentario, en la sección 6.1, regla O6.102, mencionas que los nombres de los enumeradores, cuando son usados como mascaras de bits deben estar en plural, pero tu ejemplo aparece en singular (Estilo).
28/07/2008 a las 07:03 Enviado por Space Invaders
Entre buscando el space invaders pero el enlace con firefox explore no lo encuentra, como desconectado me quede con las ganas bueno al menos me llevo tu manual, yo solo al sincliar lo conoci por revistas y soñaba nunca tuve uno mi primer lenguaje java2se muchisimas Gracias sigos tus consejos un saludo!!
19/05/2008 a las 10:37 Enviado por Eduardo
Muchas gracias por el manual.
09/05/2008 a las 20:37 Enviado por Anonimo
Excelente... continuen asi heroes!!!
03/05/2008 a las 18:37 Enviado por julian
Gracias es una estupenda ayuda y gracias por compartir esta guia...
11/01/2008 a las 18:18 Enviado por León
Gracias por compartir ese valiosa información, te felicito...
11/01/2008 a las 02:15 Enviado por Huachotiv
Bnas...sinceramente me da gusta encontrar gente como Ud. que comparte sus conocimientos adquiridos durante el tiempo que ha estado en este mundo de la computación...Admiro su desinteres, su ánimo de ayudar, al exponer sus recursos desarrollados....No queda más que decir: FELICITACIONES!!!! ..Es Ud. un ejemplo a seguir!!!! Saludos, Huacho Tiven
06/01/2008 a las 05:20 Enviado por anonymous
Esa es la gente que quiere a la gente!!!!! Es vital para la ciencia la difusión del conocimiento
04/01/2008 a las 12:35 Enviado por miguel
muchas gracias por el manual. lo he encontrado desde javahispano y me ha sido de mucha utilidad.
31/12/2007 a las 14:26 Enviado por José Luis
Gracias, gracias a los que como usted comparten, divulgan, enseñan,ayudan, sin ustedes esto no marcharía...... es un placer encontar gente como usted. Muchas Gracias.
28/12/2007 a las 16:03 Enviado por David Zuzunaga Flores
Gracias,me sirvio de mucho.
27/12/2007 a las 23:46 Enviado por ramon
Que bueno esta este manual!! Gracias...
27/12/2007 a las 17:38 Enviado por pequeña
Gracias por el manual, esta super completo saludos..
27/12/2007 a las 14:30 Enviado por Juanma
Muchas gracias por el manual, ya le estoy echando un vistazo por si hiciera alguna bestialidad programando.
27/12/2007 a las 12:27 Enviado por anonymous
Gracias por compartir esto, y enhorabuena por el trabajo.
26/12/2007 a las 19:30 Enviado por Saúl
Muy bien, con el pdf...saludos y gracias por poner material de suma importancia para los desarrolladores =D
24/12/2007 a las 12:58 Enviado por Mon
Genial... super completo y muy bien sintetizado... lo voy a tener de cabecera... Meyer fue una de mis primeras influencias... este libreto es todo un trabajo de continuación. Felicidades y gracias por dejarlo a su lectura.
24/12/2007 a las 11:36 Enviado por Alexander
Ya está solucionado; al actualizar la versión metí la pata en la URL
24/12/2007 a las 11:21 Enviado por anonymous
No se puede descargar el PDF.

 

Añadir Comentario

Nombre (opcional)
EMail (opcional, no se muestra)

Texto