Skip to content

chore: Trigger API docs deployment on release tags#2040

Merged
ananas-block merged 8 commits intomainfrom
feat/trigger-docs-on-release-tags
Nov 8, 2025
Merged

chore: Trigger API docs deployment on release tags#2040
ananas-block merged 8 commits intomainfrom
feat/trigger-docs-on-release-tags

Conversation

@tilo-14
Copy link
Copy Markdown
Member

@tilo-14 tilo-14 commented Nov 7, 2025

Summary

Changes the TypeDoc GitHub Pages deployment workflow to trigger on release tags instead of every push to main.

Changes

Examples

  • stateless.js-v0.22.1-alpha.1
  • compressed-token-v0.22.1-alpha.2

Related

tilo-14 added 7 commits November 6, 2025 15:37
Set up TypeDoc to generate API reference documentation for @lightprotocol/stateless.js and @lightprotocol/compressed-token packages. Configuration uses packages mode for monorepo support with customized options for navigation, sorting, and external links.

Changes:
- Add typedoc.json with monorepo-aware configuration
- Add TypeDoc as devDependency in root package.json
- Update .gitignore to exclude generated api-docs directory
- Update pnpm-lock.yaml with TypeDoc dependencies
Automates deployment of API documentation to GitHub Pages.
Workflow triggers on pushes to main branch and:
- Installs dependencies with pnpm
- Builds stateless.js package
- Generates TypeDoc documentation
- Deploys to GitHub Pages

Docs will be available at: https://lightprotocol.github.io/light-protocol/
Split documentation generation into separate sites for each package:
- stateless.js: /stateless.js/
- compressed-token: /compressed-token/

Changes:
- Add typedoc.stateless.json for stateless.js package
- Add typedoc.compressed-token.json for compressed-token package
- Add api-docs-index.html as landing page linking to both
- Update workflow to generate both packages separately
- Remove unified typedoc.json

URLs after deployment:
- Root: https://lightprotocol.github.io/light-protocol/
- Stateless.js: https://lightprotocol.github.io/light-protocol/stateless.js/
- Compressed-token: https://lightprotocol.github.io/light-protocol/compressed-token/
- Rename 'API Home' to 'Other Libraries' in navigation header
- Update docs.zkcompression.com to www.zkcompression.com
- Fix compressed token guide link to point to /compressed-tokens/guides
- Add 'Other Libraries' link to both package READMEs
Add Ask DeepWiki badge next to npm and license badges for quick access to AI-powered documentation assistant.
Quote GITHUB_ENV variable to prevent globbing
Changes workflow to deploy TypeDoc to GitHub Pages only when release
tags are pushed (compressed-token-* or stateless.js-*), ensuring API
documentation reflects latest release versions rather than main branch.

Addresses: #2038
@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented Nov 7, 2025

Important

Review skipped

Auto reviews are limited based on label configuration.

🏷️ Required labels (at least one) (1)
  • ai-review

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

✨ Finishing touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch feat/trigger-docs-on-release-tags

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@SwenSchaeferjohann
Copy link
Copy Markdown
Contributor

needs rebase @tilo-14

@ananas-block ananas-block changed the title Trigger API docs deployment on release tags chore: Trigger API docs deployment on release tags Nov 8, 2025
@ananas-block ananas-block merged commit 23ccd75 into main Nov 8, 2025
14 of 16 checks passed
@ananas-block ananas-block deleted the feat/trigger-docs-on-release-tags branch November 8, 2025 20:23
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.

3 participants