09 enero, 2009

Estética en la documentación de código

Siempre se ha dicho que los programadores somos muy malos diseñando. Siempre he sospechado que se trata de otra de esas generalizaciones peligrosas...

Hoy, Atul Varma publica una excelente idea: usar Javascript para presentar al vuelo la documentación de un archivo de código junto con el mismo código en dos columnas separadas tal y como puede verse a continuación...



link
. código original del ejemplo.

La idea no puede ser más acertada, ya que la mayoría de herramientas actuales exigen una etapa inevitable para generar la documentación en formato HTML (como si se estuviese compilando un ejecutable). Internamente hace uso del estándar WikiCreole para el formato.

Via Ajaxian.

Publicar un comentario en la entrada

Últimos links en indiza.com