docs icon indicating copy to clipboard operation
docs copied to clipboard

Publish API Docs using the Docusaurus TypeDoc API plugin

Open audionerd opened this issue 2 years ago • 2 comments

This adds and configures TypeDoc for API Doc publishing using https://github.com/milesj/docusaurus-plugin-typedoc-api.

To run, make sure the xstate submodule is updated and built:

git co typedoc
git submodule init
git submodule update
cd xstate
yarn
cd ..
yarn
yarn docusaurus start

Package index is at /api/next XState is at /api/next/core

Unfinished:

  • [ ] Actually fix the issue with the VersionBanner component which was preventing the docs from rendering (on this line). Disabled it via patch-package for now.
  • [x] Use the name/label core instead of xstate for xstate core in URI (e.g.: /api/next/xstate)
  • [x] Maybe just /api/<package> instead of /api/next/<package>?
  • [ ] Switch from TSDoc syntax back to more familiar JSDoc (e.g.: @remarks)
  • [ ] Fix missing links in @see?

audionerd avatar Nov 29 '23 21:11 audionerd

@audionerd is attempting to deploy a commit to the Stately Team on Vercel.

A member of the Team first needs to authorize it.

vercel[bot] avatar Nov 29 '23 21:11 vercel[bot]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Updated (UTC)
docs ✅ Ready (Inspect) Visit Preview Nov 30, 2023 10:35am

vercel[bot] avatar Nov 30 '23 10:11 vercel[bot]