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

Expose typedoc docs #55

Open
jdegger opened this issue Jun 10, 2021 · 4 comments
Open

Expose typedoc docs #55

jdegger opened this issue Jun 10, 2021 · 4 comments

Comments

@jdegger
Copy link

jdegger commented Jun 10, 2021

Hi

It would be wonderful if you could expose the TypeDoc automatically generated docs, I think this will be beneficial for loads of users.

https://typedoc.org/

Especially the methods in FusionAuthClient are ideal. I know loads of IDEs expose all the type hinting automatically, be we are in an older project without all the fancy typescript stuff which makes the documentation a must-have

@robotdan
Copy link
Member

robotdan commented Jun 11, 2021

We’ll have to figure out what we need to change to publish this when we publish to npm.

@jdegger
Copy link
Author

jdegger commented Jun 11, 2021

You could generate the docs folder through typedoc and deploy that in GitHub pages right on you main branch or create a separate branch with the docs for all releases.

To keep the docs out of your npm package you could add docs folder to .npmignore

@jdegger
Copy link
Author

jdegger commented Jun 11, 2021

Additionally, an example of the current TypeDoc output:

docs.zip

The path /docs/classes/fusionauthclient.html is the most interesting imo, typedoc might need some tweaking to make the overview a bit more readable https://typedoc.org/guides/options/#toc

Output of npx typedoc ./index.ts --toc FusionAuthClient:
docs 2.zip

@robotdan
Copy link
Member

Thanks for the additional insight @jdegger much appreciated.

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

No branches or pull requests

2 participants