The Wayback Machine - https://web.archive.org/web/20160411175647/https://github.com/dotnet/docfx
Skip to content

/docfx

Tools for building and publishing API documentation for .NET projects
  1. C# 88.2%
  2. CSS 6.5%
  3. JavaScript 3.1%
  4. HTML 1.1%
  5. PowerShell 0.5%
  6. Batchfile 0.3%
  7. Other 0.3%
C# CSS JavaScript HTML PowerShell Batchfile Other
Find file
Download ZIP
Latest commit 2a7dee7 @ansyral ansyral Merge pull request #249 from ansyral/comments 
#215 support other triple slash comments
Failed to load latest commit information.
Documentation Change uid to include version, contacts.swagger.json should be transf…
src Merge pull request #249 from ansyral/comments
test Merge pull request #249 from ansyral/comments
tools Fix creating tag in wrong branch
.gitignore remove nuget.targets
All.sln remove project Microsoft.DocAsCode.EntityModel
CONTRIBUTING.md Add .NET Foundation Info
LICENSE update nuget source
NuGet.config Revert "dnxcore50 survey"
README.md Update CI status link
RELEASENOTE.md Update dev branch to v1.8 pre-release
UpdateVersion.cmd Fix Version logic to be compatible with tag similar to *.*.*
appveyor.yml Fix #151, and add appveyor support
build.cmd Enable NuGet download behind win auth proxy during build; Fixes #178
docfx.E2E.Tests.sln add e2e tests
e2eTest.cmd add e2e tests
global.json switch to custom YamlSerializations

README.md

Generate your API documentation with DocFX

Join the chat at https://gitter.im/dotnet/docfx

Windows
master masterstatus
dev devstatus

What is it?

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

  1. Exe version which can be used as a command-line tool or inside VS IDE.
  2. DNX version which can be run cross platform.

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 Source for our 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

DocFX is supported by the .NET Foundation.

Something went wrong with that request. Please try again.