README.md

Generate your API documentation with DocFX

What's it

DocFX makes it extremely easy to generate your developer hub with API reference, landing page, and how-to.

What's next

Check out the road map of DocFX here. For more information on DocFX v3, please visit the v3 working branch.

Quick Start

choco install docfx
docfx init -q
docfx docfx_project\docfx.json --serve

For more information, please refer to Getting Started.

How to Contribute

For new comers, you can start with issues with help-wanted. Check out the contributing page to see the best places to log issues and start discussions.

This project has adopted the code of conduct defined by the Contributor Covenant to clarify expected behavior in our community. For more information see the .NET Foundation Code of Conduct.

License

DocFX is licensed under the MIT license.

.NET Foundation

DocFX is supported by the .NET Foundation.

DocFX Project

dev is the default branch accepting Pull Requests. It releases a package daily. main branch is the release branch.

How to build from source code

Prerequisites

1. Visual Studio 2019 with .NET Core cross-platform development toolset
2. Node.js

Steps

• Option 1: Run build.cmd under DocFX code repo.
• Option 2: Open docfx.sln under DocFX code repo in Visual Studio and build docfx.sln.

Build Status

main	dev

Packages

Chocolatey	Nuget

Running Status

Windows with VS2017	Ubuntu Linux with Mono