Skip to content

docs: add documentation website#77

Merged
betegon merged 44 commits intomainfrom
docs/website
Jan 27, 2026
Merged

docs: add documentation website#77
betegon merged 44 commits intomainfrom
docs/website

Conversation

@betegon
Copy link
Copy Markdown
Member

@betegon betegon commented Jan 26, 2026

Summary

Adds a GitHub Pages documentation website for the CLI, modeled after how it was done for getsentry/craft.

What's included

  • Landing page with terminal demo showing auth, issue list, and issue explain flows
  • Command reference for auth, org, project, issue, event, and api commands
  • Getting started and contributing guides
  • PR preview workflow so doc changes can be reviewed before merging
  • Craft gh-pages target for automated deployment on release

Stack

  • Astro + Starlight (same as craft docs)
  • Dark mode only, custom styling
  • Deployed to getsentry.github.io/cli

To deploy

After merging, enable GitHub Pages in repo settings:

  • Source: Deploy from a branch
  • Branch: gh-pages / root

The first release via craft will deploy the docs.

Preview locally

cd docs && bun install && bun run dev

Adds a GitHub Pages documentation website using Astro + Starlight:

- Landing page with terminal demo and feature highlights
- Command reference docs (auth, org, project, issue, event, api)
- Getting started and contributing guides
- PR preview workflow for testing doc changes
- Craft gh-pages target for deployment
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Jan 26, 2026

Semver Impact of This PR

🟢 Patch (bug fixes)

📋 Changelog Preview

This is how your changes will appear in the changelog.
Entries from this PR are highlighted with a left border (blockquote style).


New Features ✨

Issue

  • Add workspace-scoped alias cache by BYK in #52
  • Add short ID aliases for multi-project support by BYK in #31

Other

  • (api) Align with gh api and curl conventions by BYK in #60
  • (auth) Add press 'c' to copy URL during login flow by betegon in #58
  • (commands) Rename get commands to view and add -w browser flag by BYK in #53
  • Added footer formatting function by MathurAditya724 in #71
  • Add explain and plan commands (Seer AI) by MathurAditya724 in #39
  • Add Sentry SDK for error tracking and usage telemetry by BYK in #63

Bug Fixes 🐛

Issue

  • Support short ID aliases in explain and plan commands by BYK in #74
  • Use correct fallback for unrecognized alias-suffix inputs by BYK in #72
  • Handle cross-org project slug collisions in alias generation by BYK in #62
  • Use org-scoped endpoint for latest event + enhanced display by betegon in #40

Other

  • (api) Use query params for --field with GET requests by BYK in #59
  • (telemetry) Patch Sentry SDK to prevent 3-second exit delay by BYK in #85

Documentation 📚

  • (issue) Update list command tips to reference view instead of get by BYK in #73
  • (readme) Add installation section by betegon in #65
  • Add documentation website by betegon in #77
  • Update command references from 'get' to 'view' and document -w flag by BYK in #54

Internal Changes 🔧

  • (issue) Extract shared parameters for issue commands by BYK in #79
  • (release) Fix changelog-preview permissions by BYK in #41
  • Rename config folder from .sentry-cli-next to .sentry by BYK in #50

Other

  • test(e2e): use mock HTTP server instead of live API by BYK in #78

🤖 This preview updates automatically when you update the PR.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Jan 26, 2026

Codecov Results 📊

✅ Patch coverage is 100.00%. Project has 1663 uncovered lines.
✅ Project coverage is 64.79%. Comparing base (base) to head (head).

Files with missing lines (22)
File Patch % Lines
human.ts 18.35% ⚠️ 672 Missing
resolve-target.ts 18.67% ⚠️ 257 Missing
oauth.ts 21.71% ⚠️ 202 Missing
resolver.ts 3.23% ⚠️ 120 Missing
errors.ts 5.94% ⚠️ 95 Missing
api-client.ts 73.48% ⚠️ 74 Missing
api.ts 89.78% ⚠️ 47 Missing
seer.ts 75.54% ⚠️ 45 Missing
errors.ts 73.17% ⚠️ 33 Missing
seer.ts 76.15% ⚠️ 31 Missing
preload.ts 39.02% ⚠️ 25 Missing
detector.ts 87.79% ⚠️ 16 Missing
cache.ts 76.27% ⚠️ 14 Missing
telemetry.ts 89.87% ⚠️ 8 Missing
config.ts 97.11% ⚠️ 7 Missing
index.ts 95.06% ⚠️ 4 Missing
colors.ts 91.84% ⚠️ 4 Missing
env-file.ts 97.17% ⚠️ 3 Missing
utils.ts 98.64% ⚠️ 2 Missing
alias.ts 98.56% ⚠️ 2 Missing
java.ts 97.22% ⚠️ 1 Missing
parser.ts 98.63% ⚠️ 1 Missing
Coverage diff
@@            Coverage Diff             @@
##          main       #PR       +/-##
==========================================
+ Coverage    64.79%    64.79%        —%
==========================================
  Files           39        39         —
  Lines         4723      4723         —
  Branches         0         0         —
==========================================
+ Hits          3060      3060         —
- Misses        1663      1663         —
- Partials         0         0         —

Generated by Codecov Action

- Boost text contrast for better readability (body text 60% → 90%)
- Force dark mode via script injection regardless of system preference
- Style doc content: headings, paragraphs, lists, tables, code blocks
- Fix sidebar headers (GETTING STARTED, etc.) to be white
- Fix GitHub icon to be white
- Fix 'On this page' header to be white
- Widen search bar and reduce size
- Use only github-dark theme for code blocks
- Fix code block borders and styling
- Add PackageManagerCode component with integrated tabs
- Update installation page to use tabs for npm/pnpm/yarn/bun
- Fix various CSS specificity issues
@betegon betegon marked this pull request as ready for review January 27, 2026 20:44
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Jan 27, 2026

PR Preview Action v1.8.1

QR code for preview link

🚀 View preview at
https://getsentry.github.io/cli/pr-preview/pr-77/

Built to branch gh-pages at 2026-01-27 21:37 UTC.
Preview will be ready when the GitHub Pages deployment is complete.

Copy link
Copy Markdown
Contributor

@cursor cursor bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes and found 2 potential issues.

Bugbot Autofix is OFF. To automatically fix reported issues with Cloud Agents, enable Autofix in the Cursor dashboard.

@betegon betegon merged commit eda5aa2 into main Jan 27, 2026
18 checks passed
@betegon betegon deleted the docs/website branch January 27, 2026 21:42
@betegon betegon mentioned this pull request Jan 28, 2026
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