/docfx

Static site generator for .NET API documentation.

Primary LanguageC#MIT LicenseMIT

Generate your documentation with DocFX

devstatus Join the chat at https://gitter.im/dotnet/docfx Github All Releases

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

Quickstart

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.

DocFX project

Build the DocFX solution

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.

Build Status

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

main dev
Build Status Build Status

Install packages

Chocolatey Nuget
Chocolatey NuGet

Running Status

Windows with VS2017 Ubuntu Linux with Mono
VS Ubuntu

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.

DocFX is supported by the .NET Foundation.