Merge pull request #49 from microsoft/master-to-main
Update references to main branch on the tsdoc repo.
This commit is contained in:
Коммит
e0289da134
|
@ -9,14 +9,14 @@ The TSDoc projects are developed in a single GitHub monorepo:
|
|||
[https://github.com/microsoft/tsdoc](https://github.com/microsoft/tsdoc)
|
||||
|
||||
The package folders are:
|
||||
- [/tsdoc](https://github.com/microsoft/tsdoc/tree/master/tsdoc): the **@microsoft/tsdoc** package
|
||||
- [/tsdoc-config](https://github.com/microsoft/tsdoc/tree/master/tsdoc-config): the **@microsoft/tsdoc-config** package
|
||||
- [/eslint-plugin](https://github.com/microsoft/tsdoc/tree/master/eslint-plugin): the **eslint-plugin-tsdoc** package
|
||||
- [/tsdoc](https://github.com/microsoft/tsdoc/tree/main/tsdoc): the **@microsoft/tsdoc** package
|
||||
- [/tsdoc-config](https://github.com/microsoft/tsdoc/tree/main/tsdoc-config): the **@microsoft/tsdoc-config** package
|
||||
- [/eslint-plugin](https://github.com/microsoft/tsdoc/tree/main/eslint-plugin): the **eslint-plugin-tsdoc** package
|
||||
|
||||
Supplementary project folders are:
|
||||
- [/api-demo](https://github.com/microsoft/tsdoc/tree/master/api-demo): a code sample showing how to use
|
||||
- [/api-demo](https://github.com/microsoft/tsdoc/tree/main/api-demo): a code sample showing how to use
|
||||
the **@microsoft/tsdoc** library
|
||||
- [/playground](https://github.com/microsoft/tsdoc/tree/master/playground): the [TSDoc Playground](/play) web application
|
||||
- [/playground](https://github.com/microsoft/tsdoc/tree/main/playground): the [TSDoc Playground](/play) web application
|
||||
|
||||
The `tsdoc.org` website is hosted in this Github repo:
|
||||
|
||||
|
|
|
@ -25,8 +25,8 @@ a particular feature will get implemented. That said, here’s some feature area
|
|||
future investments:
|
||||
|
||||
- Collect all the design specifications from the GitHub "RFC" issues and document them on the website
|
||||
- Finish integrating the [new declaration reference syntax](https://github.com/microsoft/tsdoc/tree/master/tsdoc/src/beta)
|
||||
- Finish integrating the [new declaration reference syntax](https://github.com/microsoft/tsdoc/tree/main/tsdoc/src/beta)
|
||||
and deprecate the old syntax
|
||||
- Expand the parser to support a much broader set of CommonMark syntax elements
|
||||
- Expand the capabilities of the [tsdoc.json](https://github.com/microsoft/tsdoc/tree/master/tsdoc-config) config file
|
||||
- Expand the capabilities of the [tsdoc.json](https://github.com/microsoft/tsdoc/tree/main/tsdoc-config) config file
|
||||
- Write up a formal grammar specification
|
||||
|
|
|
@ -12,6 +12,6 @@ Even if you have not enabled a documentation tool yet for your project, adopting
|
|||
|
||||
👉 **To see how your comments would be rendered** by a compatible documentation tool, try pasting your `/** */` comment into the [TSDoc Playground](/play)!
|
||||
|
||||
👉 **Implementing a tool that needs to parse doc comments?** The [@microsoft/tsdoc](https://www.npmjs.com/package/@microsoft/tsdoc) package provides a professional quality parser. The [api-demo](https://github.com/microsoft/tsdoc/tree/master/api-demo) folder contains sample code showing how to invoke the parser.
|
||||
👉 **Implementing a tool that needs to parse doc comments?** The [@microsoft/tsdoc](https://www.npmjs.com/package/@microsoft/tsdoc) package provides a professional quality parser. The [api-demo](https://github.com/microsoft/tsdoc/tree/main/api-demo) folder contains sample code showing how to invoke the parser.
|
||||
|
||||
👉 **Have an idea for an improvement?** We're using [GitHub issues](https://github.com/Microsoft/tsdoc/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc) to discuss the TSDoc specification, library design, and project roadmap.
|
||||
|
|
|
@ -5,7 +5,7 @@ navigation_source: docs_nav
|
|||
---
|
||||
|
||||
[NPM package](https://www.npmjs.com/package/eslint-plugin-tsdoc)<br/>
|
||||
[CHANGELOG.md](https://github.com/microsoft/tsdoc/blob/master/eslint-plugin/CHANGELOG.md)
|
||||
[CHANGELOG.md](https://github.com/microsoft/tsdoc/blob/main/eslint-plugin/CHANGELOG.md)
|
||||
|
||||
This ESLint plugin provides a rule for validating that TypeScript doc comments conform to the
|
||||
[TSDoc specification](https://github.com/microsoft/tsdoc).
|
||||
|
|
|
@ -5,7 +5,7 @@ navigation_source: docs_nav
|
|||
---
|
||||
|
||||
[NPM package](https://www.npmjs.com/package/@microsoft/tsdoc-config)<br/>
|
||||
[CHANGELOG.md](https://github.com/microsoft/tsdoc/blob/master/tsdoc-config/CHANGELOG.md)
|
||||
[CHANGELOG.md](https://github.com/microsoft/tsdoc/blob/main/tsdoc-config/CHANGELOG.md)
|
||||
|
||||
|
||||
The **@microsoft/tsdoc-config** package is an optional add-on for loading the **tsdoc.json** file format that enables
|
||||
|
@ -22,7 +22,7 @@ until it finds a folder containing **tsconfig.json** or **package.json**, and th
|
|||
The **tsdoc.json** file conforms to the [tsdoc.schema.json](
|
||||
https://developer.microsoft.com/json-schemas/tsdoc/v0/tsdoc.schema.json) JSON schema. It defines tags using
|
||||
similar fields as the
|
||||
[TSDocTagDefinition](https://github.com/microsoft/tsdoc/blob/master/tsdoc/src/configuration/TSDocTagDefinition.ts)
|
||||
[TSDocTagDefinition](https://github.com/microsoft/tsdoc/blob/main/tsdoc/src/configuration/TSDocTagDefinition.ts)
|
||||
API used by `TSDocParser` from **@microsoft/tsdoc**.
|
||||
|
||||
Here's a simple example:
|
||||
|
|
|
@ -5,7 +5,7 @@ navigation_source: docs_nav
|
|||
---
|
||||
|
||||
[NPM package](https://www.npmjs.com/package/@microsoft/tsdoc)<br/>
|
||||
[CHANGELOG.md](https://github.com/microsoft/tsdoc/blob/master/tsdoc/CHANGELOG.md)
|
||||
[CHANGELOG.md](https://github.com/microsoft/tsdoc/blob/main/tsdoc/CHANGELOG.md)
|
||||
|
||||
The **@microsoft/tsdoc** package is the reference implementation of a parser for the TSDoc syntax.
|
||||
You cannot use it directly. It is an engine component intended to be incorporated into
|
||||
|
@ -141,7 +141,7 @@ console.log(isApiInternal(input));
|
|||
The library provides a number of other nice features:
|
||||
|
||||
- It tracks source code coordinates for every input token. This enables precise error messages
|
||||
for every token, and can be used to implement [syntax highlighting](https://github.com/microsoft/tsdoc/blob/master/playground/src/SyntaxStyler/DocNodeSyntaxStyler.ts).
|
||||
for every token, and can be used to implement [syntax highlighting](https://github.com/microsoft/tsdoc/blob/main/playground/src/SyntaxStyler/DocNodeSyntaxStyler.ts).
|
||||
|
||||
- It provides an Abstract Syntax Tree that makes it easy
|
||||
to [render rich text](https://github.com/microsoft/tsdoc/blob/26c4bab8efb04bc5d1619585e1f071bcc10cf16a/playground/src/DocHtmlView.tsx#L140)
|
||||
|
@ -155,6 +155,6 @@ The library provides a number of other nice features:
|
|||
|
||||
## Invoking the TSDoc parser
|
||||
|
||||
The [api-demo folder](https://github.com/microsoft/tsdoc/tree/master/api-demo) provides a more complete example.
|
||||
The [api-demo folder](https://github.com/microsoft/tsdoc/tree/main/api-demo) provides a more complete example.
|
||||
It also contains an "advanced" example, illustrating how to interface TSDoc with the parse tree returned by
|
||||
the TypeScript compiler engine.
|
||||
|
|
|
@ -17,12 +17,12 @@ implementation of a parser, and many syntax details are explained in the code co
|
|||
|
||||
The **"old"** syntax for declaration references is detailed in this technical note:
|
||||
|
||||
[/spec/code-snippets/DeclarationReferences.ts](https://github.com/microsoft/tsdoc/blob/master/spec/code-snippets/DeclarationReferences.ts)
|
||||
[/spec/code-snippets/DeclarationReferences.ts](https://github.com/microsoft/tsdoc/blob/main/spec/code-snippets/DeclarationReferences.ts)
|
||||
|
||||
The **"new"** syntax for declaration references is described in this grammar:
|
||||
|
||||
[/tsdoc/src/beta/DeclarationReference.grammarkdown](https://github.com/microsoft/tsdoc/blob/master/tsdoc/src/beta/DeclarationReference.grammarkdown)
|
||||
[/tsdoc/src/beta/DeclarationReference.grammarkdown](https://github.com/microsoft/tsdoc/blob/main/tsdoc/src/beta/DeclarationReference.grammarkdown)
|
||||
|
||||
Examples of the new syntax can be found in the
|
||||
[DeclarationReference.test.ts](https://github.com/microsoft/tsdoc/blob/master/tsdoc/src/beta/__tests__/DeclarationReference.test.ts)
|
||||
[DeclarationReference.test.ts](https://github.com/microsoft/tsdoc/blob/main/tsdoc/src/beta/__tests__/DeclarationReference.test.ts)
|
||||
file.
|
||||
|
|
|
@ -6,7 +6,7 @@ navigation_source: docs_nav
|
|||
|
||||
Three "standardization groups" are used to classify the standard TSDoc tags, according to the
|
||||
the level of support expected from compatible documentation tools. They correspond to the
|
||||
[Standardization enum](https://github.com/microsoft/tsdoc/blob/master/tsdoc/src/details/Standardization.ts)
|
||||
[Standardization enum](https://github.com/microsoft/tsdoc/blob/main/tsdoc/src/details/Standardization.ts)
|
||||
in the parser API.
|
||||
|
||||
|
||||
|
|
Загрузка…
Ссылка в новой задаче