Skip to content

code-walkthrough: auto glossary, overview/detailed modes, group verdicts, always-on review bar, bump to 1.5.0 - #63

Merged
crisperity merged 1 commit into
mainfrom
cw-auto-glossary
Nov 6, 2026
Merged

crisperity merged 1 commit into
mainfrom
cw-auto-glossary

Conversation

@crisperity

Copy link
Copy Markdown
Owner

The page explains its own jargon and lets you review from the pictures alone.

  • Glossary: a glossary step picks up to 12 project terms from the page text. Their first occurrence in each block gets a dotted underline and a hover/focus/long-press definition. Thread replies add their own terms.
  • Overview: when concept cards exist, the text Overview shrinks to a bold lead; the rest stays in Detailed. Cards are picture first, then a caption, with Before/After/Why collapsed. Pages without concepts are unchanged.
  • Modes: an Overview/Detailed toggle (default Detailed, remembered per walkthrough). Overview hides diffs and hunk bodies.
  • Group verdicts: one "Looks good" / "Needs changes" mark per group replaces the per-file "viewed" checkbox. "Looks good" collapses the group's files.
  • Review bar: always visible on live pages, with Comment / Request changes / Approve. It shows 3/5 checked · 1 needs changes and highlights the suggested verdict. The dialog pre-fills the summary with the "Needs changes" groups. Approve with open groups warns but never blocks.
  • Zero-comment submit: the bar sends direct, so Approve and Request changes work without any pending review. A review opened only for that submit is deleted if the submit fails. A Comment with no summary and nothing pending is rejected.

Not tried in a browser: hover and re-marking, mode toggle, chips, bar and dialog, mobile layout. The zero-comment submit was tested against a fake gh, not real GitHub. The glossary step has not run against a real model.

…cts, always-on review bar, bump to 1.5.0

The page explains its own jargon and lets you review from the pictures alone.

- Glossary: a `glossary` step picks up to 12 project terms from the page text. Their first occurrence in each block gets a dotted underline and a hover/focus/long-press definition. Thread replies add their own terms.
- Overview: when concept cards exist, the text Overview shrinks to a bold lead; the rest stays in Detailed. Cards are picture first, then a caption, with Before/After/Why collapsed. Pages without concepts are unchanged.
- Modes: an Overview/Detailed toggle (default Detailed, remembered per walkthrough). Overview hides diffs and hunk bodies.
- Group verdicts: one "Looks good" / "Needs changes" mark per group replaces the per-file "viewed" checkbox. "Looks good" collapses the group's files.
- Review bar: always visible on live pages, with Comment / Request changes / Approve. It shows `3/5 checked · 1 needs changes` and highlights the suggested verdict. The dialog pre-fills the summary with the "Needs changes" groups. Approve with open groups warns but never blocks.
- Zero-comment submit: the bar sends `direct`, so Approve and Request changes work without any pending review. A review opened only for that submit is deleted if the submit fails. A Comment with no summary and nothing pending is rejected.
@crisperity
crisperity merged commit 6a50194 into main Nov 6, 2026
2 checks passed
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