flagon-useralejs icon indicating copy to clipboard operation
flagon-useralejs copied to clipboard

chore(docs): Add API documentation

Open EandrewJones opened this issue 9 months ago • 2 comments

Problem

We need maintainable documentation of our library's API, at minimum

Solution

Use TypeDoc or sphinx-js autodoc. TypeDoc is likely better since we're migrating to TS (#442).

EandrewJones avatar May 07 '24 15:05 EandrewJones

Hi @EandrewJones I was looking into the API documentation requirement. If it is REST API, I'd love to help you with the documentation. Thanks!

kanz-1805 avatar May 12 '24 09:05 kanz-1805

@kanz-1805 UserALE is not a REST API. It is a javasript library used on the client-side (browser) of web applications to help track user behavior.

We need to auto-generate documentation for all of the functions (collectively, the API) so that we can publicly share it via something like ReadTheDocs. The process will be very similar to how you would generate documentation for a REST API, but slightly different in terms of the tooling you would use. For instance, we will probably use TypeDoc since we already have docstrings for most of our functions and are in the middle of migrating to typescript.

Is there a particular reason why you are only interested in a REST API?

EandrewJones avatar May 14 '24 02:05 EandrewJones