How to create website from XML documentation comments?

I would like to create a documentation website from C# XML documentation comments.

An example from the Python community. This Scipy documentation is created from this python code using a tool named Sphinx.

Is anything like that possible for a C# project?


Example of XML documentation comments in a .NET project (not mine) https://github.com/haf/NodaTime/blob/master/src/NodaTime/Period.cs#L26

/// <summary>
/// Represents a period of time expressed in human chronological terms: hours, days,
/// weeks, months and so on. All implementations in Noda Time are immutable, and return fields
/// in descending size order: hours before minutes, for example.
/// </summary>
public sealed class Period : IEnumerable<DurationFieldValue>, IEquatable<Period>

Edit: The full extent of advice I could find in other questions was 'use Sandcastle'. As far as I can tell from its (ironically limited) documentation, it can only create Windows help files (.chm). Is that correct?

Jon Skeet
people
quotationmark

Edit: The full extent of advice I could find in other questions was 'use Sandcastle'. As far as I can tell from its (ironically limited) documentation, it can only create Windows help files (.chm). Is that correct?

No, that's not correct. Sandcastle can build a wide range of output.

However, these days you really want Sandcastle Help-File Builder (SHFB) which makes things a whole lot better. Still not entirely painless, but pretty good. The documentation for SHFB is generally pretty reasonable, too.

Funny you should give an example of Noda Time - SHFB is precisely what we use to generate our online API reference.

people

See more on this question at Stackoverflow