Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: use tsdoc @link syntax for .d.ts comments #1450

Merged
merged 1 commit into from
Nov 28, 2022
Merged

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).

Verified

This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
@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.

None yet

2 participants