Git Product home page Git Product logo

docfx's Introduction

Generate your API documentation with DocFX

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

What's it

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

What's next

Check out the road map of DocFX here. For more information on DocFX v3, please visit the v3 working branch.

Quick Start

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

For more information, please refer to Getting Started.

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.

.NET Foundation

DocFX is supported by the .NET Foundation.

DocFX Project

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

How to build from source code

Prerequisites

  1. Visual Studio 2019 with .NET Core cross-platform development toolset
  2. Node.js

Steps

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

Build Status

main dev
Build Status Build Status

Packages

Chocolatey Nuget
Chocolatey NuGet

Running Status

Windows with VS2017 Ubuntu Linux with Mono
VS Ubuntu

docfx's People

Contributors

vwxyzh avatar vicancy avatar superyyrrzz avatar qinezh avatar 928pjy avatar hellosnow avatar fenxu avatar ansyral avatar herohua avatar yufeih avatar chenkennt avatar v-pegao avatar adunndevster avatar yishengjin1413 avatar marzinz avatar icnocop avatar pascalberger avatar sharanya-rao avatar simoncropp avatar tianqizhang avatar bitbonk avatar peterennis avatar daxianji007 avatar duncanma avatar huachao avatar surban avatar partychen avatar alaincroisetiere avatar travelmarx avatar jsntcy avatar

Watchers

James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.