Skip to content

Conversation

@erickzhao
Copy link
Member

@erickzhao erickzhao commented Nov 25, 2022

Linking to other APIs in TypeDoc can be done through two ways: [[ target ]] or {@link target}.

The [[target]] syntax is TypeDoc-specific (see TypeStrong/typedoc#1317) while {@link target} is a TSDoc standard (see spec).

Two reasons for migrating over:

  • TSDoc has deprecated the [[target]] syntax and is fully removing it in v0.24 (see CHANGELOG).
  • As of TypeScript 4.3, {@link target} is used for smarter editor intellisense (see release notes).

@erickzhao erickzhao requested a review from a team November 25, 2022 23:01
@erickzhao erickzhao merged commit 0b705de into main Nov 28, 2022
@erickzhao erickzhao deleted the docs-link-syntax branch November 28, 2022 19:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants