Picacodigos

Los desarrolladores de Mono siguen desesperados por hacernos probar su port de .NET a entornos *nix.

Bien por ellos. Ya en su día nos facilitaron las cosas mediante Monoppix, esa modificación de Knoppix que le añadía Mono para que pudiéramos probar el IDE sin tener que instalar nada.

Siguen empeñados en hacernos las cosas fáciles: ahora la idea que han tenido es distribuir una imagen de una SuSE 10 con Mono, MySQL y alguna otra herramienta listada, lista para ejecutarse con el gratuito VM Player. Pero yo me pregunto, ¿es suficiente?

MonoDevelop, el IDE para Mono, incluye MonoDoc; que es la documentación de todas las clases que componen Mono. Para que os hagáis una idea, MonoDoc es muy similar a la ayuda que viene con el JDK de Java: por cada clase nos informa de su nombre, del espacio de nom bres o paquete al que pertenece, y nos detalla su colección de métodos, propiedades y eventos. Y ya está.

Y no es suficiente.

Sería suficiente si no existiera MSDN, pero da la casualidad de que existe. Y MSDN no se limita a darnos información sobre la clase que varias decenas de herramientas pueden generar automáticamente desde los comentarios escritos en el código, por ejemplo GhostDoc. No, MSDN incluye ejemplos de uso. Para el 90% de las páginas que tiene, MSDN incluye un ejemplo de uso tanto en C# como en VB.NET. ¿Cuesta tanto añadirlos? ¿Es tan difícil?

Si, ya sé que es un coñazo documentar. Lo he sufrido. Sí, ya sé que es más divertido añadir más funcionalidades antes que explicar bien las que ya se tienen. Pero alguien tendrá que hacerlo.