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

Publish API Docs using the Docusaurus TypeDoc API plugin #288

Draft
wants to merge 7 commits into
base: main
Choose a base branch
from

Conversation

audionerd
Copy link
Contributor

@audionerd audionerd commented Nov 29, 2023

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.
  • Use the name/label core instead of xstate for xstate core in URI (e.g.: /api/next/xstate)
  • 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?

Copy link

vercel bot commented Nov 29, 2023

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

A member of the Team first needs to authorize it.

Copy link

vercel bot commented Nov 30, 2023

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

- `/api/xstate` instead of `/api/core`
- `/api/@xstate/react` instead of `/api/xstate-react`
@davidkpiano davidkpiano mentioned this pull request Dec 7, 2023
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

Successfully merging this pull request may close these issues.

1 participant