effection
effection copied to clipboard
RFC: Embed API documentation into website
Motivation
Deno website is hosting our API docs. Although convenient, it might send the wrong message to those unfamiliar with Deno.
It would be nice to have API docs hosted on our website.
Approach
We could use the same mechanism we use for v2 docs to serve API docs for different versions. This requires having the generated HTML somewhere we can download it. We could run a workflow on any effection-v* tag that generates HTML using Deno CLI, commit it, and push it to the tag.
This would allow us to read the docs for each version from the tag's tarball.