08 febrero 2006

Autogenerando la ayuda

Como hace tiempo que no publico nada, hoy lanzo algo muy poco elaborado, pero para cubrir la nómina. Se trata de un proyecto para la generación automática de ayuda sobre .NET, nDoc. Es un proyecto de código abierto (está en SourceForge) que aporta la funcionalidad de javaDoc a .NET. No sé si hay otras alternativas además de nDoc, si Microsoft está detrás o en cambio tiene otro proyecto para esto (porque algo tiene que tener, están hartos de verlo en java).
También me gustaría saber cómo elaborar más esa ayuda, ya que realmente javaDoc genera ayuda para el programador (lo cual es útil), y nDoc lo hará igual para los summary que estamos añadiendo al principio de los métodos (con ///), pero ¿cómo generar ayuda para el usuario? ¿Cómo específicar qué hace cada elemento de un interfaz de usuario, añadir imágenes e hiperenlaces (referencias mutuas), etcétera? Esto creo que queda aún muy lejos de la tecnología actual, por lo que hay que especificarlo manualmente en el bloc de notas (que es como el lenguaje ensamblador de las ayudas).

1 Comments:

Blogger Pablo said...

Unos meses después de publicar esto, buscando algo parecido con Alex, acabo de encontrar un artículo de CodeProject (son la Wikipedia de la programación) profundizando en la generación de los archivos XML de ayuda desde Visual Studio y su 'maquetación' con nDoc para generar una ayuda tal cual la de VS2005. Ah, que se me olvida, aquí va el artículo: http://www.codeproject.com/csharp/csharpcodedocumentation.asp

08 mayo, 2006 15:19  

Publicar un comentario

<< Home