Skip to content
forked from korzh/aistdoc

Aistdoc allows you to publish an API reference for your .NET/C# or TypeScript code on the web via Aistant (https://aistant.com) documentation hosting service

License

Notifications You must be signed in to change notification settings

onlyutkarsh/aistdoc

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

44 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AistDoc utility

What is AistDoc

AistDoc is an API documentation generator and publishing tool for your code. Currently it supports:

Main AistDoc features:

  1. It collects all information about your code: the list of namespaces, structures, interfaces, enums, and classes as well as methods and properties of the classes and interfaces.

  2. It generates Markdown (or HTML) files which represent the full reference of your API (one file for each class, interface or enum). If your code contains XML documentation (for .NET projects) or TSDoc (for TypeScript) comments - then those comments will be added to the generated articles as well.
    NB1: For TypeScript projects, you will also need to process your code with TypeDoc tool first.
    NB2: Here you can find the detailed description of TSDoc comments format.

  3. It publishes the documentation generated on step #2 on the Web using Aistant service as a hosting platform.

As a result, you will get a nice website with full API reference of your code. Since Aistant is a general-purpose service for managing knowledge bases and help centers - you can add to that documentation your own articles with basic concepts of your project, tutorials, code samples, etc .

Installation

Aistdoc is implemented as a .NET Core Global Tool, so its installation is quite simple:

dotnet tool install -g Aistant.DocImport

To update it to the latest version, if it was installed previously, use:

dotnet tool update -g Aistant.DocImport

NB: Of course you need .NET Core SDK (version 2.1 or higher) be installed on your computer (Linux, Windows or Mac) first.

Tutorials

For details on how to publish your documentation please read one of our tutorials:

About

Aistdoc allows you to publish an API reference for your .NET/C# or TypeScript code on the web via Aistant (https://aistant.com) documentation hosting service

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C# 99.9%
  • Batchfile 0.1%