fusionauth-typescript-client icon indicating copy to clipboard operation
fusionauth-typescript-client copied to clipboard

Expose typedoc docs

Open jdegger opened this issue 4 years ago • 4 comments

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

jdegger avatar Jun 10 '21 13:06 jdegger

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

robotdan avatar Jun 11 '21 01:06 robotdan

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 avatar Jun 11 '21 06:06 jdegger

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

jdegger avatar Jun 11 '21 06:06 jdegger

Thanks for the additional insight @jdegger much appreciated.

robotdan avatar Jun 14 '21 15:06 robotdan