candy-kingdom / summary

Flexible and effortless API reference generator for .NET.
MIT License
9 stars 0 forks source link
api-reference csharp csharp-library documentation documentation-generator dotnet net roslyn xml xml-parser
Logo

<summary>

Flexible and effortless API reference generator for .NET.

Nuget

Usage

Currently, the generator is pretty young. In order to use it, you should download Summary (Core), Summary.Roslyn (Parser) and Summary.Markdown (Renderer) packages.

Here is a simple code-snippet that parses files in the specified directory and renders them into Markdown format:

// The folder you want to parse the `*.cs` files from.
const string input = "./src";

// The folder you want to put the generator output into.
const string output = "./docs";

await new SummaryPipeline()
    .UseRoslynParser(input)
    .UseMdRenderer(output)
    .UseDefaultFilters()
    .Run();

Examples

Consider checking out the docs directory: it's the Summary summary generated by Summary. :sun_with_face: