Skip to content

Docs + README: v0.3 surfaces + status badges#77

Merged
djankov merged 1 commit into
mainfrom
docs/v03-surfaces-and-badges
Jun 19, 2026
Merged

Docs + README: v0.3 surfaces + status badges#77
djankov merged 1 commit into
mainfrom
docs/v03-surfaces-and-badges

Conversation

@djankov

@djankov djankov commented Jun 19, 2026

Copy link
Copy Markdown
Contributor

Documents the v0.3 surfaces — the VS Code extension and the per-model leaderboard — across the README and the MkDocs site, and adds the standard astro-tools status-badge row. Docs-only; no package changes.

README

  • Status-badge row (CI, Docs, PyPI, Python versions, License) under the title.
  • New In your editor section: install from the Marketplace / Open VSX, the apply-to-current-file flow.
  • Extended what gmat-copilot is not: no auto-apply without review; the only hosted artifact is the (presentation-only) board.
  • Leaderboard paragraph now covers reading the board and submitting an entry.

Docs site

  • New docs/vscode.md — commands, settings, the apply-to-current-file UX, and the gmat-script division of labour.
  • Two new examples wired into the nav: Drive it from VS Code (editor walkthrough) and Reproduce a leaderboard entry (submission flow).
  • Refreshed the public decisions snapshot with the VS Code surface and the leaderboard + anti-overfitting decisions.
  • getting-started gains editor + leaderboard pointers; api documents the leaderboard module; index aligns "what it's not".

The existing docs/leaderboard.md already covers the board, the public/held-out anti-overfitting design, the firewall, the schema, and the submit/verify flow, so it is unchanged.

Verification

  • uv run mkdocs build --strict passes with no warnings; the three new pages render.
  • No issue/PR numbers in docs prose; console blocks are ASCII.

Closes #68.
Closes #51.

Document the v0.3 surfaces — the VS Code extension and the per-model
leaderboard — across the README and the MkDocs site, and add the standard
status-badge row.

- README: add the CI/Docs/PyPI/Python-versions/License badge row; add an
  "In your editor" section for the VS Code extension; extend "what
  gmat-copilot is not" with no-auto-apply and the board being the only
  hosted artifact; note the leaderboard submission path.
- New docs/vscode.md: commands, settings, the apply-to-current-file flow,
  and the gmat-script division of labour.
- New examples: an editor walkthrough and a reproduce-a-leaderboard-entry
  submission walkthrough; wired into the nav.
- Refresh the public decisions snapshot with the VS Code surface and the
  leaderboard + anti-overfitting decisions.
- getting-started: editor + leaderboard pointers; api: the leaderboard
  module; index: align "what it's not".

Closes #68.
Closes #51.
@djankov djankov merged commit bd76b2d into main Jun 19, 2026
16 checks passed
@djankov djankov deleted the docs/v03-surfaces-and-badges branch June 19, 2026 15:28
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.

README: add status badges (CI, Docs, PyPI, Python versions, License) Docs + README: v0.3

1 participant