docs-typescript
TypeScript icon, indicating that this package has built-in type declarations

0.1.7 • Public • Published

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)

Examples

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

Package Sidebar

Install

npm i docs-typescript

Weekly Downloads

1

Version

0.1.7

License

MIT

Unpacked Size

381 kB

Total Files

418

Last publish

Collaborators

  • fedyna