Documentar código en Visual Studio 2010 utilizando Sandle Castle

Que tal fanáticos de la documentación. Recientemente me han solicitado documentar cierto código desarrollado en C# con Visual Studio 2010. Me tome a la tarea de desarrollarlo.

Bueno, para iniciar les recomiendo el blog escrito por mi compañero Jack para que se familiaricen con los tags de documentación en Visual Studio.

Ahora lo siguiente que tienen que hacer es descargar Sandle Castle.

NOTA: A mi me sucedió algo curioso ya que al parecer desconfiguro algo en mi Visual Studio 2010, y lo único que tuve que hacer fue reinstalarlo (pero no confirmo que sea por la instalación de Sandle Castle).

Comencemos con abrir Visual Studio 2010:

  1. Abrir el código en “Visual Studio 2010”,
  2. En el “Explorador de soluciones” seleccionar el código con el botón secundario del ratón y dar clic en la opción “Propiedades”,
  3. En la ventana de “Propiedades” del proyecto seleccionar la pestaña “Generar”. En el apartado “Resultado” seleccionar la casilla “Archivo de documentación XML”,
  4. En el menú principal de “Visual Studio 2010” seleccionar “Generar” y después “Generar Solución”.

Ahora continuaremos abriendo Sandle Castle:

  1. En el menú superior seleccionamos la opción “File” y enseguida la opción “New Project”,
  2. En la ventana “Project Explorer” hacer clic con el botón secundario del ratón en el nodo “Documentation Sources”  y seleccionar la opción “Add documentation sources…”,
  3. En la ventana de diálogo, seleccionar el proyecto que se desea documentar,
  4. En la ventana “Project Properties”, seleccionar la opción “Build”,
  5. Seleccionar los tipos de archivos de ayuda que se desean generar. Recomiendo seleccionar uno por uno,
  6. Guardar el proyecto,
  7. Presionar el botón “Build”,
  8. Es recomendable configurar otras opciones para depurar bien el archivo de salida, pero queda fuera para los fines de este blog 😀

La verdad la documentación que se genera esta bien, los invito a que lo prueben y alimenten este blog.

Saludos.

Analista/Desarrollador y cofundador de QBit Mexhico. Tecnologías utilizadas Android, Java (EJB, Servlets, Faces, Groovy & Grails, Maven, Swing), .Net (C#, VB, ASP, MVC), Delphi, Spring, Hibernate, DTSx, Oracle, T-SQL, Firebird, MySQL, MongoDB, NodeJs, ReactJs (Flux). Sistemas Operativos Mac, Ubuntu y Windows.

Twitter LinkedIn 

Compartir en...Tweet about this on TwitterPin on Pinterest0Share on LinkedIn0Share on Google+0Share on Facebook6