¿Cómo exporto la documentación del código en C # / VisualStudio 2008?

Siempre he hecho un punto de escribir comentarios de código agradable para clases y métodos con la syntax de C # xml. Siempre esperé poder exportarlos fácilmente más tarde.

Hoy tengo que hacerlo, pero tengo problemas para descubrir cómo. ¿Se me escapa algo? Quiero ir a Menu-> Build-> Build Code Documentation , pero no hay opción para hacer eso, ahí.

En realidad está en las propiedades del proyecto. Cree la pestaña, la sección Salida, el archivo de documentación XML e ingrese el nombre del archivo. Se construirá en cada comstackción del proyecto.

Después de eso puedes construir la ayuda real con Sandcastle .

Puede probar NDOC o SandCastle si no le importa usar herramientas de terceros.

Sandcastle funciona bastante bien para generar documentación y admite un par de formatos diferentes para la generación. Que yo sepa, no hay ninguna integración de Visual Studio para él, pero hay un SandcastleGUI para él que está disponible.

Tenga cuidado si usa LINQ to SQL, ya que no podrá agregar fácilmente comentarios sostenibles a los objetos generados automáticamente.

Comentario tardío, pero vale la pena agregar que a pesar de que Sandcastle está inactivo, el Sandcastle Help File Builder permanece en desarrollo activo, y encontré que es muy poderoso y sencillo para bucear cuando se trata solo de esta situación: instale en rich .chm y .html /.asp salida en un par de horas.

El proyecto original de NDoc (mencionado por otros) está muerto, pero hay un nuevo proyecto llamado NDoc3 .

NDoc3 soporta .NET 2.0 – 3.5. Actualmente está disponible como una versión beta y funcionó muy bien para mí. No estoy seguro de si el proyecto aún está activo: la última versión beta se lanzó en abril de 2009.