Skip to content

Latest commit

 

History

History
60 lines (46 loc) · 2.95 KB

README.md

File metadata and controls

60 lines (46 loc) · 2.95 KB

Welcome on DNDocs!

image

What is DNDocs?

DNDocs (Dot Net Docs) is a free documentation hosting platform for .NET projects

Problem: Host .NET API Documentation

There is not effortless way to create and host API documentation for .NET Core projects. Current tools requires to integrate with build and publishing process to maintain docs up-to-date

Solution: DNDocs

Insert following markdown into README.md file:

[![Static Badge](https://img.shields.io/badge/API%20Docs-DNDocs-190088?logo=readme&logoColor=white)](https://dndocs.com/?packageName={PackageName}&packageVersion={PackageVersion})

For example:

[![Static Badge](https://img.shields.io/badge/API%20Docs-DNDocs-190088?logo=readme&logoColor=white)](https://dndocs.com/?packageName=Microsoft.EntityFrameworkCore&packageVersion=8.0.3)

Result: Static Badge

Docfx API explorer is hosted online.

When I should use DNDocs?

You don't have any API Explorer for Your .NET project and want to host it in one minute -> use DNDocs

Motivation

Looking on github C# repositories lots of them did not have any documentation online. To take a look on basic project structure and what methods are exposed we needed to open open each .cs file just to simply look what functions and methods are there. Also there was not any website that allows to just simply generate and host documentation for .NET Core project online.

Share with URL

Url to documentation can be shared in any form, for example:

  1. Put dndocs API Explorer URL to github project README
  2. Generate shields.io badge with Project API Explorer, for example: Static Badge (look below in this document for 'shields.io badge informations' to see how to generate exactly same badge)
  3. Or anything other

shields.io badge informations:
Badge on shields.io can be generated with any parameters
but as an example above I generated badge with following parameters:
badgeContent: API Docs-DNDocs-190088
logo: readme
logoColor: white
Ready to copy-paste markdown badge (only replace 'WWWdndocsCOM/API_EXPLORER_LINK' with valid url):

[![Static Badge](https://img.shields.io/badge/API%20Docs-DNDocs-190088?logo=readme&logoColor=white)](WWWdndocsCOM/API_EXPLORER_LINK)

Report Bugs

If You find any bugs or unexpected behaviour please report this in 'issues' tab in this repository


Projects list:

https://docs.dndocs.com/system/projects/29 https://docs.dndocs.com/system/projects/28 https://docs.dndocs.com/system/projects/27 https://docs.dndocs.com/system/projects/26 https://docs.dndocs.com/system/projects/25 [etc.]