Skip to main content

TSDoc-Spec-Overview

Technical details for the TSDoc syntax are tracked by "RFC" issues with the Request for Comments GitHub label.

The @microsoft/tsdoc package provides a feature complete reference implementation of a parser, and many syntax details are explained in the code comments for its source code.

This section is still under development. We'll post more detail soon.

Declaration referencesโ€‹

The "old" syntax for declaration references is detailed in this technical note:

/spec/code-snippets/DeclarationReferences.ts

The "new" syntax for declaration references is described in this grammar:

/tsdoc/src/beta/DeclarationReference.grammarkdown

Examples of the new syntax can be found in the DeclarationReference.test.ts file.