Documentación que entorpece la calidad
¿Hasta cuando será suficiente documentar el código? Uno de nuestros clientes revisa detenidamente el código fuente en las entregas, o por los menos a primera vista eso parece, sin embargo, me he dado cuenta que el foco principal de la revisión es la documentación del código, esto prosupuesto no tiene nada de extraño ni de malo, pero en mi opinión se ha perdido un aspecto importante de la revisión: la calidad del código entregado.
Cada día me encuentro con código duplicado, extensas funciones y métodos o nulo control de errores, es evidente que las revisiones ponen mas énfasis en la forma que en el fondo, dejando atrás los muchos otros aspectos que hablan acerca de la calidad del software. Bajo este planteamiento los mejores códigos serán aquellos que están más documentados, sin considerar aspectos como el tamaño, la complejidad de los algoritmos, el uso eficiente de recursos, entre muchas otras cosas.
Hoy en día el escenario global resalta otras metodologías y prácticas, una de ellas es el refactoring, definido de forma simple como la mejora del diseño del código existente, el cuál debido al acoplamiento existente entre la documentación y su código, se ve entorpecido; en cierto sentido la documentación desincentiva la iniciativa de refactorizar poniendo barreras a la mejora.
Es indudable que la documentación del código nos ahorrara varios dolores de cabeza y frustración pero cuando nos nubla la vista y adormece nuestros sentidos es hora de preocuparse.
Firefox, simplemente es mejor
Nos soy de esos que históricamente han manifestado su repudio al gigante Microsoft, no utilizo Internet Explorer porque no vaya de acuerdo a mis ideas en cuanto a código abierto, simplemente utilizo Firefox por que es mejor. No he analizado en detalle la experiencia de usuario en uno u otro navegador, no he comparado su rendimiento, su seguridad, etc., tal vez en otras áreas Firefox no sea el que la lleva, el hecho es que en mi área Firefox es por mucho el gran ganador. Es tan grande este sentimiento que he incorporado la pregunta “¿que navegador utilizas?” en la entrevista a desarrolladores. ¿Y por qué tal diferencia y adhesión?, la razón es simple y esta dada por una serie de plugins que me hacen ser mas eficiente, construir aplicaciones de calidad en un menor tiempo, en fin ser más productivo.
He aquí un pequeño listado de mis plugins favoritos:
Aardvark, me permite limpiar páginas antes de la impresión quitando así esos molestos banners publicitarios.
Firebug, herramienta indispensable para todo desarrollador, permite inspeccionar y editar HTML, inspeccionar el modelo de objetos DOM, ver los errores, depurar javascript y mucho más.
Web Developer, agrega una barra a Firefox con un montón de utilidades como resaltado de tablas, manejo de formularios, validación de CSS y HTML , información de la página, etc.
Selenium IDE, graba y reproduce nuestra navegación en una página, está herramienta ha sido creada con el propósito de realizar pruebas a nuestras páginas y lo logra de una manera muy sencilla.
Fireshoot, es una extensión que nos permite crear ScreenShoot de páginas Web y realizar anotaciones sobre estos.
TamperData, permite seguir y modificar las solicitudes HTTP, ideal para comprobaciones de seguridad (modificando los datos) y para hacer seguimiento a los request.
Google Notebook, nos permite realizar anotaciones rápidas a medida que vamos navegando.
Javascript Shell, esta es una pequeña pero potente shell para javascript sin duda una de mis favoritas.
¿El mejor debería ser despedido?
Creo que era el titulo de un viejo post que no encontré, pero es lo que me viene a la cabeza al pensar en aquellos “buenos programadores” que escudados en su supuesta “excelencia” se sienten con el derecho de ser tratados diferentes, no quieren ensuciarse las manos. No me mal interpreten, la mayoría de las veces intento poner a cada uno en el puesto que me parece más acorde de acuerdo a su perfil, sin embargo, eso no siempre es posible. Cuando la situación lo amerita necesitamos gente flexible, capaz de abordar uno u otro rol. Por ahora las malas caras me comienzan a irritar, siendo sincero prefiero un programador un poco menos hábil pero en el que pueda confiar.






