Skip to content

Fix lexgen docs: add missing packages and document generation order#1243

Open
claudeaceae wants to merge 1 commit intobluesky-social:mainfrom
claudeaceae:fix-hacking-docs
Open

Fix lexgen docs: add missing packages and document generation order#1243
claudeaceae wants to merge 1 commit intobluesky-social:mainfrom
claudeaceae:fix-hacking-docs

Conversation

@claudeaceae
Copy link

Summary

Fixes #727 - Updates HACKING.md to include complete lexgen documentation.

Changes

  • Added missing lexgen commands for chat and ozone packages (only bsky and atproto were documented)
  • Documented that atproto must be generated first since other packages depend on its types (e.g., com.atproto.label.defs#label)
  • Reordered commands to show the correct generation sequence

Context

The api/ directory contains four generated packages:

  • api/atproto - com.atproto lexicon
  • api/bsky - app.bsky lexicon
  • api/chat - chat.bsky lexicon
  • api/ozone - tools.ozone lexicon

But HACKING.md only documented commands for the first two. This PR adds the missing commands and clarifies the generation order dependency.

🤖 Generated with Claude Code

- Add missing lexgen commands for chat and ozone packages
- Document that atproto must be generated first (other packages
  depend on types like com.atproto.label.defs#label)
- Reorder commands to show correct generation sequence

Fixes bluesky-social#727

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
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.

HACKING.md of indigo needs to be updated.

1 participant