Skip to content

docs(deck): voice + Red Hat Display pass on the Python deck - #95

Merged
patterncatalyst merged 2 commits into
mainfrom
docs/deck-voice-font-python
Oct 28, 2026
Merged

patterncatalyst merged 2 commits into
mainfrom
docs/deck-voice-font-python

Conversation

@patterncatalyst

Copy link
Copy Markdown
Owner

Summary

  • Professional-voice pass on Designing-Cloud-Native-APIs-Python.pptx: recast all 451 ban-tier em dashes (comma, colon, semicolon, or parentheses, chosen per context) and dropped or renamed 44 numbered chapter/section/appendix cross-references ("section 11", "(Appendix H)", "§12") in favour of naming the concept directly. Code boxes and inline code are untouched; voice-scan.sh and the lgtm-professional-voice skill scanner both report 0 ban-tier hits on the deck's text copy.
  • Font pass: retargeted every Overpass-family typeface declaration to Red Hat Display across the deck (1586 font elements: a:latin/a:ea/a:cs on each title run plus a:buFont/a:sym on the bullet-glyph paragraph properties). Red Hat Mono (5886) and Red Hat Text (5368) element counts are unchanged; raw Overpass no longer appears anywhere in the slide XML.
  • Adds scripts/deck_font.py (python-pptx, reuses MONO_RE/run_font from deck_edit.py) with a report-then-apply workflow, since deck_edit.py has no font operation.
  • Regenerated the sidecar lgtm-presentation/text/Designing-Cloud-Native-APIs-Python.md and the edit file lgtm-presentation/edits/voice-python.json (469 replace ops, exact-match counts).
  • Only the Python deck was touched; the other five language decks and both policy decks are untouched (confirmed via git status and by deck_text.py --write reproducing byte-identical output for all other sidecars).

Verification

  • python3 scripts/deck_text.py --check → ok
  • bash scripts/voice-scan.sh (full repo gate) → 0 ban-tier hits (site, examples, decks)
  • bash ~/.claude/skills/lgtm-professional-voice/scripts/scan.sh --tier ban --hits all on the Python deck's sidecar → 0 hits
  • python3 scripts/validate_site.py → 42 files, 0 errors, 0 warnings
  • unzip -p ... 'ppt/slides/slide*.xml' | grep -o Overpass | wc -l → 0
  • unzip -p ... 'ppt/slides/slide*.xml' | grep -o 'Red Hat Mono' | wc -l → 5886 (unchanged)
  • unzip -p ... 'ppt/slides/slide*.xml' | grep -o 'Red Hat Display' | wc -l → 1586

Test plan

  • deck_text.py --check clean
  • voice-scan.sh ban tier 0 (repo-wide)
  • validate_site.py 0 errors/warnings
  • Overpass/Mono/Display raw XML counts verified
  • Visual spot-check of a rendered sample of slides (titles now in Red Hat Display) — left for reviewer since brand fonts must be installed locally to render

Recast all 451 ban-tier em dashes (451 unique non-code paragraph
segments) in Designing-Cloud-Native-APIs-Python.pptx with a comma,
colon, semicolon, or parentheses, and dropped or renamed 44
chapter/section/appendix number cross-references ("section 11",
"(Appendix H)", "§12") in favour of naming the concept directly.
Code boxes and speaker-note comments are untouched.

scripts/deck_edit.py lgtm-presentation/edits/voice-python.json applies
the 469 replace ops; lgtm-presentation/text/Designing-Cloud-Native-APIs-Python.md
is the regenerated sidecar. voice-scan.sh and deck_text.py --check are
both clean.
Retarget every Overpass-family typeface declaration to Red Hat
Display in Designing-Cloud-Native-APIs-Python.pptx: 1586 font
elements (a:latin, a:ea, a:cs on each title run's rPr, plus
a:buFont/a:sym on the bullet-glyph pPr) across all slides. Red Hat
Mono (5886) and Red Hat Text (5368) element counts are unchanged;
raw "Overpass" no longer appears anywhere in the slide XML.

Adds scripts/deck_font.py (python-pptx), reusing MONO_RE/run_font
from deck_edit.py; report mode previews the change count before
--apply rewrites the deck in place.
@patterncatalyst
patterncatalyst merged commit 35043b5 into main Oct 28, 2026
17 checks passed
@patterncatalyst
patterncatalyst deleted the docs/deck-voice-font-python branch October 28, 2026 14:04
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