Skip to content

yodamaster/docfx

 
 

Repository files navigation

Generate your API documentation with DocFX

| | Windows | | ---------- | --------- | ------ | master | masterstatus | dev | devstatus

What is it?

DocFX makes it extremely easy to generate your developer hub, complete with API reference, landing page, and how-to. There are currently two versions of the tool:

  • Windows specific IDE version which uses .NET Framework and works with VS 2015 community
  • Cross platform console version which uses .NET Core and DNX

We currently support C# and VB projects.

How to build?

Prerequisites

  1. VS 2015 community or above
  2. DNVM

Steps

  1. dnvm install 1.0.0-rc1-final
  2. Run build.cmd under docfx code repo

Possible build issues

  1. DNX.PackageManager not found
    Install http://www.microsoft.com/en-us/download/details.aspx?id=49442. Note that there are 2 msi to be installed.
  2. Test failure with message \r\n not equal to \n for Windows
    Set git config --global core.autocrlf true

How do I play with docfx?

Please refer to Getting Started.

What's included?

File/Folder Description
LICENSE Project license information
README.md Introduction to the project
CONTRIBUTING.md Contribution guidelines to how to contribute to the repo
Documentation Documentation project using docfx to produce the documentation site
src Source code for docfx
test Test cases for docfx using xunit test framework
tools Source code for tools used in code build and deployment

How to Contribute

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

The DocFX is supported by the .NET Foundation.

About

Tools for building and publishing API documentation for .NET projects

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C# 86.1%
  • CSS 7.7%
  • JavaScript 3.8%
  • HTML 1.3%
  • PowerShell 0.4%
  • Batchfile 0.4%
  • Roff 0.3%