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

[RFC]: add support for adding links to API docs in the JSDoc #2560

Open
3 tasks done
Snehil-Shah opened this issue Jul 11, 2024 · 3 comments
Open
3 tasks done

[RFC]: add support for adding links to API docs in the JSDoc #2560

Snehil-Shah opened this issue Jul 11, 2024 · 3 comments
Labels
difficulty: 4 Likely to be moderately difficult. Documentation Improvements, additions, or changes to documentation. Needs Discussion Needs further discussion. RFC Request for comments. Feature requests and proposed changes. Tools Issue or pull request related to project tooling. TypeScript Issue involves or relates to TypeScript.

Comments

@Snehil-Shah
Copy link
Member

Snehil-Shah commented Jul 11, 2024

Description

This RFC proposes linking to the API docs directly from the JSDoc allowing users to easily open up the full docs through the IntelliSense overlays in IDEs

image

This would have to be automated as the URL might change and is prone to human errors if manually done.

Related Issues

No.

Questions

No.

Other

No.

Checklist

  • I have read and understood the Code of Conduct.
  • Searched for existing issues and pull requests.
  • The issue name begins with RFC:.
@Snehil-Shah Snehil-Shah added RFC Request for comments. Feature requests and proposed changes. Documentation Improvements, additions, or changes to documentation. labels Jul 11, 2024
@kgryte kgryte added TypeScript Issue involves or relates to TypeScript. Tools Issue or pull request related to project tooling. labels Jul 11, 2024
@AbhinavKRN
Copy link

hey @kgryte , can you assign this issue to me!

@kgryte
Copy link
Member

kgryte commented Jul 16, 2024

@AbhinavKRN Thanks for volunteering to work on this. However, I am not sure how this would work and what would be involved.

Before doing any coding on this, I suggest first doing some R&D and making a proposal on this RFC regarding how you plan to implement a solution. That upfront design will help reduce the design space and allow us to iterate a bit before committing to a technical approach and hopefully help reduce wasted effort.

@kgryte kgryte added Needs Discussion Needs further discussion. difficulty: 4 Likely to be moderately difficult. labels Jul 16, 2024
@AbhinavKRN
Copy link

Sure @kgryte , on it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
difficulty: 4 Likely to be moderately difficult. Documentation Improvements, additions, or changes to documentation. Needs Discussion Needs further discussion. RFC Request for comments. Feature requests and proposed changes. Tools Issue or pull request related to project tooling. TypeScript Issue involves or relates to TypeScript.
Projects
None yet
Development

No branches or pull requests

3 participants