DocFX makes it extremely easy to generate your developer hub with a landing page, API reference, and conceptual documentation, from a variety of sources.

Install DocFX and deploy a sample documentation web site:

1. Open a console.

2. Enter the following commands to install DocFX and build/deploy a sample site:

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

3. Go to https://localhost:8080 to view the sample DocFX site.

For more information, refer to Getting Started.

To build the DocFX binaries from the Visual Studio solution:

1. Install Visual Studio 2019 with .NET Core cross-platform development toolset

2. Install Node.js

3. Build the solution using one of the following options:

   • Option 1: Console
     • Open a DOS console and navigate to your DocFX clone subdirectory.
     • Run build.cmd.
   • Option 2: Visual Studio
     • Open a PowerShell console and navigate to your DocFX clone subdirectory.
     • Run ./UpdateTemplate.ps1 to generate the template files required by the Visual Studio solution.
     • Open the docfx.sln solution in your DocFX clone subdirectory from Visual Studio and build it.

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

main	dev

Chocolatey	Nuget

Windows with VS2017	Ubuntu Linux with Mono

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.

DocFX is licensed under the MIT license.

DocFX is supported by the .NET Foundation.