@microsoft/tsdoc
A parser for the TypeScript doc comment syntax
Last updated 18 days ago by odspnpm .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install @microsoft/tsdoc 
SYNC missed versions from official npm registry.

@microsoft/tsdoc

This library is the reference implementation of a parser for the TSDoc syntax. Using this library is an easy way to ensure that your tool is 100% compatible with the standard.

What is TSDoc?

TSDoc is a proposal to standardize the doc comments used in TypeScript source files. It allows different tools to extract content from comments without getting confused by each other's syntax. The TSDoc notation looks pretty familiar:

export class Statistics {
  /**
   * Returns the average of two numbers.
   *
   * @remarks
   * This method is part of the {@link core-library#Statistics | Statistics subsystem}.
   *
   * @param x - The first input number
   * @param y - The second input number
   * @returns The arithmetic mean of `x` and `y`
   *
   * @beta
   */
  public static getAverage(x: number, y: number): number {
    return (x + y) / 2.0;
  }
}

Give it a try!

Check out the TSDoc Playground for a cool live demo of our parser!

API Usage

The api-demo folder on GitHub illustrates how to invoke the TSDoc parser.

A separate NPM package @microsoft/tsdoc-config is used for loading the tsdoc.json file.

Get involved

The TSDoc project is actively evolving. Please visit our GitHub project for the latest documentation, instructions for building/debugging the projects, and other resources:

https://github.com/microsoft/tsdoc

Current Tags

  • 0.12.21                                ...           latest (18 days ago)

39 Versions

  • 0.12.21                                ...           18 days ago
  • 0.12.20                                ...           4 months ago
  • 0.12.19                                ...           6 months ago
  • 0.12.18                                ...           7 months ago
  • 0.12.17                                ...           7 months ago
  • 0.12.16                                ...           10 months ago
  • 0.12.15                                ...           10 months ago
  • 0.12.14                                ...           a year ago
  • 0.12.13                                ...           a year ago
  • 0.12.12                                ...           a year ago
  • 0.12.11                                ...           a year ago
  • 0.12.10                                ...           a year ago
  • 0.12.9                                ...           a year ago
  • 0.12.8                                ...           2 years ago
  • 0.12.7                                ...           2 years ago
  • 0.12.6                                ...           2 years ago
  • 0.12.5                                ...           2 years ago
  • 0.12.4                                ...           2 years ago
  • 0.12.3                                ...           2 years ago
  • 0.12.2                                ...           2 years ago
  • 0.12.1                                ...           2 years ago
  • 0.12.0                                ...           2 years ago
  • 0.11.0                                ...           2 years ago
  • 0.10.0                                ...           2 years ago
  • 0.9.3                                ...           2 years ago
  • 0.9.2                                ...           2 years ago
  • 0.9.1                                ...           2 years ago
  • 0.9.0                                ...           2 years ago
  • 0.8.1                                ...           2 years ago
  • 0.8.0                                ...           2 years ago
  • 0.7.0                                ...           2 years ago
  • 0.6.0                                ...           2 years ago
  • 0.5.0                                ...           2 years ago
  • 0.4.1                                ...           2 years ago
  • 0.4.0                                ...           2 years ago
  • 0.3.0                                ...           2 years ago
  • 0.2.0                                ...           2 years ago
  • 0.1.0                                ...           2 years ago
  • 0.0.0                                ...           2 years ago

Copyright 2014 - 2016 © taobao.org |