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

Generate docs for README-only package #2264

Closed
cprussin opened this issue Apr 26, 2023 · 1 comment
Closed

Generate docs for README-only package #2264

cprussin opened this issue Apr 26, 2023 · 1 comment
Labels
enhancement Improved functionality good first issue Easier issue for first time contributors
Milestone

Comments

@cprussin
Copy link
Contributor

Search terms

readme, packages

Question

I have one package in my monorepo that just exports shared tsconfig.json files. As such, that package doesn't have any entry points for typedoc to use. However, I'd still like that package included in my documentation, with just the README rendered in the package's section of the docs (or maybe with the contents of the json files if possible). It seems like right now, typedoc bails on any package that doesn't have entry points, but is there a way to tell typedoc to generate a README-only doc site (or include the json contents possibly)?

@cprussin cprussin added the question Question about functionality label Apr 26, 2023
@Gerrit0
Copy link
Collaborator

Gerrit0 commented Apr 29, 2023

Currently no on both counts. This is a pretty good argument for not bailing with no entry points though, at least for nested packages... it seems reasonable to downgrade that to a warning if entryPoints is not set, and allow it silently if it's set to an empty array.

Including json files is not something typedoc is designed to do at all. You could write a plugin to create a fake reflection type that does it, but that'd still depend on typedoc not bailing if there are no entry points.

@Gerrit0 Gerrit0 added enhancement Improved functionality good first issue Easier issue for first time contributors and removed question Question about functionality labels Apr 29, 2023
@Gerrit0 Gerrit0 closed this as completed in 26df2ac May 5, 2023
@Gerrit0 Gerrit0 added this to the v0.24.7 milestone Jun 4, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement Improved functionality good first issue Easier issue for first time contributors
Projects
None yet
Development

No branches or pull requests

3 participants
@cprussin @Gerrit0 and others