Skip to content

docs: standardize v0.8 install snippets - #535

Merged
jeffhuber merged 1 commit into
mainfrom
codex/docs-v08-install-snippet-followup
Sep 2, 2026
Merged

docs: standardize v0.8 install snippets#535
jeffhuber merged 1 commit into
mainfrom
codex/docs-v08-install-snippet-followup

Conversation

@jeffhuber

Copy link
Copy Markdown
Contributor

Summary

  • standardize remaining v0.8 install snippets on the explicit CODE_MOWER_PYTHON pattern
  • include the OSS v1 checklist in the active-doc release hygiene guard
  • block the stale bare python3.12 pipx snippet from returning to active docs

Verification

  • scripts/dev-python -m unittest tests.test_release_hygiene
  • stale-snippet scan across README.md, docs, src, and .github
  • git diff --check

@jeffhuber jeffhuber added builder:codex Code Mower generated label tier:R Code Mower generated label needs-claude-audit needs-gitar-audit Code Mower generated label labels Sep 2, 2026
@gitar-bot

gitar-bot Bot commented Sep 2, 2026

Copy link
Copy Markdown
Code Review ✅ Approved

Standardizes v0.8 install snippets to use the explicit CODE_MOWER_PYTHON pattern, adds the OSS v1 checklist to the release hygiene guard, and blocks a stale bare python3.12 pipx snippet from returning to active docs. No issues found.

Options

Auto-apply is off → Gitar will not commit updates to this branch.
Display: compact → Showing less information.

Comment with these commands to change the behavior for this request:

Auto-apply Compact
gitar auto-apply:on         
gitar display:verbose         

Was this helpful? React with 👍 / 👎 | Gitar

@jeffhuber

Copy link
Copy Markdown
Contributor Author

Claude audit (merge-authority lane)

Head SHA: 5a5a04cb42113e833f6998876aa769c54d7c8db7
Findings: P0=0, P1=0, P2=0, P3=1 (blocker policy: any P0/P1/P2 -> BLOCKED)

Claude Audit: PASS

Summary:

Docs-only PR standardizing the pinned pipx install snippet to resolve python3.12 via command -v instead of a bare interpreter name, matching the pattern already used elsewhere in docs/pypi-release.md and docs/install.md. The accompanying test_release_hygiene.py update correctly extends the stale-phrase and active-docs checks to cover all three touched files. No functional code changed; no security, data-loss, or contract issues found.

Findings:

  • [P3] Slightly awkward inline-code phrasing -- docs/v08-release-notes.md:4
    Finding ID: claude:697dfe51f175232e879a
    The sentence splits the CODE_MOWER_PYTHON assignment and the pipx install into two separate inline code spans joined by "followed by", which reads awkwardly compared to a fenced code block used in the other two updated docs. Non-blocking style nit.

@jeffhuber
jeffhuber merged commit f104bec into main Sep 2, 2026
23 checks passed
@jeffhuber
jeffhuber deleted the codex/docs-v08-install-snippet-followup branch September 2, 2026 17:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

builder:codex Code Mower generated label claude-audit-done needs-gitar-audit Code Mower generated label tier:R Code Mower generated label

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant