/live-documenter

.NET documentation generator and live reader. Generate documentation from .NET code and xml comments, fast, quick and easy.

Primary LanguageC#MIT LicenseMIT

Live Documenter

Live Documenter Tweet

Build Status

Don't let comments hide in your source code! Read it, search it and publish it with Live Documenter. Documentation for .NET made easy.

Live Documenter is a suite of applications and libraries that enable the live viewing and automatic generation of documentation from .NET code and xml comment files. Learn what Live Documenter is from our homepage and download the latest version.

View documentation live and up to date!

Create beautiful static documentation.

Or use the API library to integrate in to your own projects.


Introduction

The Live Documenter is a desktop application, console utility and API library designed to make your .NET code and comments more readable and more available. Lets free them from the confines of the xml squirrelled away in your source code and put them to good use!

Get started by downloading the latest version and reading the quick start guide.

Desktop Application

The desktop application allows visual studio projects, solutions or libraries to be opened and documentation generated for them from the XML comment files live. If changes are made to the codebase these are reflected in the application when the project is re-built.

It also provides a nice interface for exporting documentation, reading and printing.

Console Application

The exporter application is useful for integrating documentation generation in to existing processes; such as your build scripts or creating ad-hoc documentation.

API Library

A DLL that can be referenced by projects to automatically generate documentation at runtime. Details of the API and how to use it can be found in the documentation.

Installation

This will only work on Windows at the moment, work is ongoing to transfer to netstandard and to make everything except the desktop application cross platform on .NET Core.

A zip file of the latest version is provided. To install, download the file, unzip and execute from the directories.

Build Latest

Requirements

  • .NET Core SDK 3.1

The latest code has been worked on in Visual Studio 2019 and several of the projects have been transferred to netstandard libraries and use the latest csproj file format.

Please let me know if there are any issues building from source so I can resolve them.

Helping the project

All help is appreciated. There is an associated documentation site that can always be improved.

If you would like to get involved in the project, please take a look at the current issues. Make a note of your interest, get the latest version and create a pull request when you are ready to merge the changes.

Also simply providing feedback via GitHub issues helps to make sure the project is being made more stable and is being constantly enhanced.