• Build Status

	Build Status	Package	Chocolatey
master
dev

• Running Status

Running Status	Windows with .NET Core v2.0.3	Windows with VS2017	Ubuntu Linux with Mono	Mac with Mono

Let's make DocFX better together!

Vote for the proposals you like, and add yours:

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

We currently support C# and VB projects.

1. Visual Studio 2017, minimum installation is enough.
2. Node.js, for building templates.

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

1. Option 1: install docfx through chocolatey package: choco install docfx -y.
2. Option 2: install docfx through nuget package: nuget install docfx.console, docfx.exe is under folder docfx.console/tools/.
3. Option 3: play docfx inside Visual Studio: create a Class Library (.NET Framework) project, Manage Nuget Packages to install docfx.console nuget package on the project, Build to create the generated website under folder _site.

For more information, please refer to Getting Started.

1. Install docfx through chocolatey package choco install docfx -y

2. Call docfx docfx docfx.json

docfx-seed project provides a sample integrating with AppVeyor.

NOTE: Known issue in AppVeyor: Currently platform: Any CPU in appveyor.yml causes docfx metadata failure. dotnet#1078

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.

Thanks go to our community of developers who have helped improve the quality of DocFX by helping with code contributions. Contributors:

DocFX is licensed under the MIT license.

DocFX is supported by the .NET Foundation.