Skip to content

Conversation

@kcmartin
Copy link
Collaborator

Summary

Rewrites the Checkpoints concept doc to follow our writing style guide and fix technical inaccuracies.

  • Fixed CLI commands: sprite restoresprite checkpoint restore
  • Updated SDK examples: Aligned with API reference (async iterables, correct method names, error handling)
  • Fixed incorrect reference: /.sprite/llm.txt is read-only docs, not writable
  • Fixed NDJSON format: Uses type field, not status
  • Applied writing style: Contractions, short paragraphs, action-oriented headings, no filler phrases
  • Removed redundancy: ~170 lines removed (~27% smaller)
  • Fixed typos: "Checkpoings", "Considerationss", extra spaces

Before merging

  • Verify SDK examples against actual API (if there's a test suite)
  • Remove draft: true from frontmatter when ready to publish
  • Uncomment Related Documentation section when linked pages are published

🤖 Generated with Claude Code

kcmartin and others added 11 commits January 23, 2026 19:30
- Remove redundant Sprites explanation (readers come from other pages)
- Tighten language, add specific timing (~300ms)
- More direct closing sentence

Co-Authored-By: Claude Opus 4.5 <[email protected]>
- Fix typos (extra space, "setup sand")
- Simplify bullet list formatting
- Remove redundant 300ms mention (in intro)
- Consolidate "don't include" items into prose
- Explain copy-on-write in plain terms

Co-Authored-By: Claude Opus 4.5 <[email protected]>
- Remove redundant speed/interrupt mentions (covered earlier)
- Remove code comment that duplicated prose
- Tighten SDK intro paragraph

Co-Authored-By: Claude Opus 4.5 <[email protected]>
Align with API reference:
- Go: use CreateCheckpointWithComment, handle ProcessAll error
- JavaScript: use async iterable instead of manual stream reading
- Elixir: simplify message handling

Co-Authored-By: Claude Opus 4.5 <[email protected]>
- Fix CLI command: sprite restore -> sprite checkpoint restore
- Fix typo: Considerationss -> Considerations
- Update SDK examples to match API reference
- Tighten prose, remove redundant info
- Simplify considerations list

Co-Authored-By: Claude Opus 4.5 <[email protected]>
- Fix typos in intro, remove filler sentence
- Simplify CLI output table formatting
- Remove ctx declarations from Go examples
- Rename 'Checkpoint Information' to 'Get Checkpoint Details'
- Rename 'Deleting Checkpoints' to 'Delete a Checkpoint'
- Simplify delete callout, merge Cleanup Considerations

Co-Authored-By: Claude Opus 4.5 <[email protected]>
- Rename from 'Manage Checkpoints with the API Inside Your Sprite'
- Remove filler phrases and redundant explanations
- Fix incorrect llm.txt reference (it's read-only docs, not writable)
- Consolidate NDJSON format info
- Fix response format to use 'type' field (matches API reference)
- Simplify self-checkpointing example

Co-Authored-By: Claude Opus 4.5 <[email protected]>
- Remove redundant copy-on-write bullet (explained earlier)
- Simplify marketing-style language
- Fix em-dash

Co-Authored-By: Claude Opus 4.5 <[email protected]>
- Fix sprite restore -> sprite checkpoint restore (3 occurrences)
- Remove filler intro sentence
- Simplify deployment rollback logic
- Remove verbose code comments

Co-Authored-By: Claude Opus 4.5 <[email protected]>
- Rename to action-oriented heading
- Remove redundant SDK examples (CLI only)
- Remove 'Integrate with LLMs' (covered earlier)
- Fix broken anchor link to delete section
- Simplify Git section, remove 'Bad' example

Co-Authored-By: Claude Opus 4.5 <[email protected]>
Some linked pages are still drafts. Will restore when ready.

Co-Authored-By: Claude Opus 4.5 <[email protected]>
@github-actions
Copy link
Contributor

CLI Documentation Generator

Metric Value
CLI Version 0.0.1
Commands Generated 24
Tests ✅ 0/0 passed
📚 Commands documented
  • sprite login
  • sprite logout
  • sprite org auth
  • sprite org list
  • sprite org logout
  • sprite org keyring disable
  • sprite org keyring enable
  • sprite auth setup
  • sprite create
  • sprite use
  • sprite list
  • sprite destroy
  • sprite exec
  • sprite console
  • sprite checkpoint create
  • sprite checkpoint list
  • sprite checkpoint info
  • sprite checkpoint delete
  • sprite restore
  • sprite proxy
  • sprite url
  • sprite url update
  • sprite api
  • sprite upgrade

@github-actions
Copy link
Contributor

Preview Deployment

Name URL
Preview https://pr-107-superfly-sprites-docs.fly.dev

Commit: a874b40

@github-actions
Copy link
Contributor

E2E Test Results

✅ Tests success

Ran against: https://pr-107-superfly-sprites-docs.fly.dev

@github-actions
Copy link
Contributor

Lighthouse Results

⚠️ Lighthouse failed to collect results. This may be due to the preview deployment not being ready.

@kcmartin kcmartin requested a review from kylemclaren January 24, 2026 00:26
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.

2 participants