Living Documentation Generation Edit on GitHub

StorytellerDocGen is a separate tool that provides the means to author and publish "Living Documentation" for code-centric projects. The documentation authoring and publishing is somewhat inspired by Read The Docs. The primary philosophy guiding this tooling has been to make it as easy as possible to keep the documentation synchronized with the API it documents and quick to update.

StorytellerDocGen is distributed in the dotnet_stdocs Nuget package.

See How I’m Documenting OSS Projects from Jeremy's blog.

The Storyteller documentation consists of four small applications:

1. An embedded web application in the dotnet stdocs tool (dotnet stdocs run) distributed with StorytellerDocGen that provides an auto-reloading preview of the documentation.

2. A command line tool (dotnet stdocs export) bundled into dotnet stdocs that generates static html from your raw documentation that can be published on the web (the Storyteller documentation is hosted in GitHub Pages) or in a form that is browsable from the file system so that the content could be included in downloadable packages.

3. A command line tool (dotnet stdocs seed) bundled into dotnet stdocs to quickly generate the shell of a documentation structure.

4. A simplistic command to write out the skeleton of a new documentation project at dotnet stdocs new.

Documentation content is written the the popular Markdown syntax with some Storyteller specific customizations for navigation elements, embedding code samples, or Storyteller specifications.

To learn more about what the documentation generation capabilities of Storyteller are, see these topics:

• Getting Started with Documentation Generation
• Running the Documentation Website Locally
• Exporting the Documentation
• Documentation Skinning
• Authoring Topics
• Creating a Navigation Structure
• Linking to Other Topics
• Embedding Code Samples
• Embedding Images
• Topic Outlines
• Bootstrap Alerts
• Embedding Storyteller Specifications