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

Documenting transitive types in API/symbols? #165

Open
arv opened this issue Mar 4, 2024 · 0 comments · May be fixed by #591
Open

Documenting transitive types in API/symbols? #165

arv opened this issue Mar 4, 2024 · 0 comments · May be fixed by #591
Labels
docs gen Related to the documentation generation

Comments

@arv
Copy link

arv commented Mar 4, 2024

I was browsing the @badrap/valita symbols and the generated API docs and I see a lot of symbols are not linked/documented.

For example:

https://jsr.io/@badrap/valita/doc/~/ArrayType#method_func_0

func(arr: unknown, flags: number): RawResult<ArrayOutput<Head, Rest>>

Here neither RawResult nor ArrayOutput are linked or documented. These two type definitions are not exported by src/index.ts so it is understandable that they are not linked. But, to make things useful the reader of the API docs would want to see what these types are even if they cannot be imported directly.

@marvinhagemeister marvinhagemeister added bug docs gen Related to the documentation generation labels Mar 4, 2024
@lucacasonato lucacasonato added this to JSR Mar 4, 2024
@github-project-automation github-project-automation bot moved this to Needs Plan in JSR Mar 4, 2024
@lucacasonato lucacasonato moved this from Needs Plan to Needs Triage in JSR Mar 4, 2024
@lucacasonato lucacasonato moved this from Needs Triage to Needs Plan in JSR Mar 5, 2024
@crowlKats crowlKats removed the bug label Mar 5, 2024
@crowlKats crowlKats linked a pull request Jun 3, 2024 that will close this issue
@crowlKats crowlKats moved this from Needs Plan to Ready in JSR Jan 17, 2025
@crowlKats crowlKats moved this from Ready to In Progress in JSR Jan 17, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs gen Related to the documentation generation
Projects
Status: In Progress
Development

Successfully merging a pull request may close this issue.

3 participants