Initial commit
This commit is contained in:
56
node_modules/@microsoft/tsdoc/README.md
generated
vendored
Normal file
56
node_modules/@microsoft/tsdoc/README.md
generated
vendored
Normal file
@@ -0,0 +1,56 @@
|
||||
# @microsoft/tsdoc
|
||||
|
||||
<div>
|
||||
<br />
|
||||
<a href="https://tsdoc.org/">
|
||||
<img width="200" src="https://tsdoc.org/images/site/tsdoc.svg">
|
||||
</a>
|
||||
<p />
|
||||
</div>
|
||||
|
||||
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](http://www.typescriptlang.org/) 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:
|
||||
|
||||
```typescript
|
||||
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](https://tsdoc.org/play) for a cool live demo of our parser!
|
||||
|
||||
|
||||
## API Usage
|
||||
|
||||
The [api-demo](https://github.com/microsoft/tsdoc/tree/main/api-demo) folder on GitHub illustrates how
|
||||
to invoke the TSDoc parser.
|
||||
|
||||
A separate NPM package [`@microsoft/tsdoc-config`](https://www.npmjs.com/package/@microsoft/tsdoc-config)
|
||||
is used for loading the **tsdoc.json** file.
|
||||
|
||||
|
||||
## Get involved
|
||||
|
||||
The **TSDoc** project is actively evolving. Please visit the website for the latest documentation, instructions for building/debugging the projects, and other resources:
|
||||
|
||||
https://tsdoc.org/
|
||||
Reference in New Issue
Block a user