docs-typescript v0.1.7

Docs Typescript - Documenting Typescript made easy

Tool for documenting Typescript APIs using API Extractor Model with support for Markdown, Docusaurus (WIP) and HTML (WIP). Alternative to api-documenter and TypeDoc with better UX, much richer API presentation and support for single and multi page documentation.

Getting Started

Create configuration

• Creates docs.config.json, api-extractor.json and tsdoc.json files with default values

npx docs-typescript init

Extract API Model from declaration files

• Defaults to types/index.d.ts file

npx docs-typescript extract

Build documentation form API Model

• Defaults to api.json file, creates docs folder with documentation

npx docs-typescript build

Documentation

For all the details see DocsTypescript.com, for API documentation see DocsTypescript.com/api (Work in Progress)

• api-extractor
• tsdoc

Examples

• Markdown on Github | Multi Page
• Markdown on Github | Single Page
• Markdown with Docusaurus

Supported TSDoc tags

• @remarks
• @example
• @type
• @typeParam
• @returns
• @info
• @alert
• @error
• @author
• @since
• @public
• @beta
• @alpha
• @internal
• @deprecated

For more informations visit Doc comment syntax

Roadmap

• Markdown support
• Single page / Multi page
• Project website
• Support for @link tag
• React support (categories for components/hooks/providers)
• Mermaid support to present inheritance and dependencies
• Create and use api-extractor alternative in form of extractor-typescript
• Docusaurus (MDX) output support
• HTML output support