Skip to content

docs(deck): voice + Red Hat Display pass on the data-mesh decks - #22

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

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

Conversation

@patterncatalyst

Copy link
Copy Markdown
Owner

Summary

Professional-voice pass + font fix on the two pptxgenjs-built decks in presentation/:

  • The Data Mesh 101 (presentation/data-mesh-101/build-101.js → The_Data_Mesh_101.pptx)
    • Baseline: 43 ban-tier hits (40 em dash + "earns its place" x2 + "stated plainly") + 1 chapter/section cross-reference ("Section 1 covers...").
    • After: 0 ban-tier hits, 0 chapter/section cross-references.
  • Data Mesh on OpenShift (presentation/data-mesh-openshift/build-deck.js + deck-lib.js → Data_Mesh_on_OpenShift.pptx)
    • Baseline: 175 ban-tier hits (152 em dash + deliberately/load-bearing/earns-its-place/worth-noticing/honest/on-purpose/not-a-toy/rest-of-deck) + 7 "section 0N" cross-references.
    • After: 0 ban-tier hits, 0 chapter/section cross-references.

Also replaced the F.head font token, "Overpass SemiBold" → "Red Hat Display", in both decks (body Red Hat Text and code/mono Red Hat Mono unchanged), updating the matching source comments.

Both decks were rebuilt after each change set. Verified on the rebuilt .pptx XML:

  • grep -c Overpass on ppt/slides/slide*.xml → 0 for both decks.
  • grep -c "Red Hat Display" → 14 (101 deck) / 62 (OpenShift deck).
  • grep -c "Red Hat Mono" unchanged (2 / 14) confirming code font untouched.
  • 0 em dashes in slides + notes XML for both rebuilt decks.

Code boxes, diagram images, filenames, and product/identifier names were left untouched; only slide prose and speaker notes were edited.

Two commits: a voice pass, then the font swap, each with its own rebuild.

Deferred

Deferred: 2 source-less pptx still contain em dashes (74 / 120); no JS source, flagged for a follow-up decision.

  • presentation/Data-Mesh-100-Data-Architectures-r1.0.pptx — 74 em dashes.
  • presentation/data-mesh-101/The_Data_Mesh_Updated.pptx — 120 em dashes.

These two decks have no generating JS source in this repo, so they were left untouched. scripts/forbidden-syntax.sh does not scan for voice/em-dash patterns (it checks tunnel/port-forward/podman/other-OS syntax), so it reports OK regardless; this PR does not claim these two decks are voice-clean.

Test plan

  • scan.sh --tier ban on build-101.js → 0
  • scan.sh --tier ban on build-deck.js + deck-lib.js → 0
  • node build-101.js and node build-deck.js rebuild cleanly
  • Rebuilt .pptx XML has 0 Overpass, has Red Hat Display, mono unchanged
  • Rebuilt .pptx XML has 0 em dashes in slides/notes
  • scripts/forbidden-syntax.sh → OK
  • Source-less pptx (Data-Mesh-100-Data-Architectures-r1.0.pptx, The_Data_Mesh_Updated.pptx) untouched in the diff

Remove em dashes, chapter/section cross-references, and ban-tier verbal
tics (deliberately, earns its place, load-bearing, worth noticing, honest,
on purpose, not a toy, rest of this deck) from The Data Mesh 101 and
Data Mesh on OpenShift pptxgenjs sources, then rebuild both decks.
Replace the Overpass SemiBold heading font token with Red Hat Display in
both pptxgenjs sources (The Data Mesh 101, Data Mesh on OpenShift) and
rebuild; body (Red Hat Text) and code (Red Hat Mono) fonts are unchanged.
@patterncatalyst
patterncatalyst merged commit 6ecc0ff into main Oct 28, 2026
1 check passed
@patterncatalyst
patterncatalyst deleted the docs/deck-voice-font branch October 28, 2026 13:33
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