Skip to content

docs(deck): refresh all eight decks, gate their text copies (S12) - #72

Merged
patterncatalyst merged 19 commits into
mainfrom
docs/deck-refresh
Oct 12, 2026
Merged

patterncatalyst merged 19 commits into
mainfrom
docs/deck-refresh

Conversation

@patterncatalyst

Copy link
Copy Markdown
Owner

S12 of the modernization plan: every deck in lgtm-presentation/ reviewed and refreshed in place.

Decks

  • Six language decks: versions match the S2–S8 pins, code slides follow examples/, Appendix R (minikube) added, no Appendix S slides, vendor-neutral (no cloud SDKs, ACS or OpenShift reliance), professional voice, every slide has notes.
  • K8s-Environment-Access-Policies (kubeconform) and Network-Policy-Process-Advisory (reworked to upstream Kubernetes + open source: NetworkPolicy/AdminNetworkPolicy, Cilium/Calico, Kyverno/Gatekeeper, Trivy, Falco), with their .md/.docx companions.
  • Toolkit: scripts/deck_text.py, deck_edit.py, deck_render.sh, deck_fit.py; edit files under lgtm-presentation/edits/; Markdown text copies under lgtm-presentation/text/.

CI gate (content-ok): deck_text.py --check; the voice scan, positional, old-engine and stale-stack denylist checks now cover lgtm-presentation/ Markdown. Scanner re-vendored from lgtm-skills a93f128.

Examples fixed (found while aligning slides; verify.sh green in all six languages on Docker Engine):

  • demo-01: /readyz answers 503 when the database is down (13/13).
  • demo-21: async-signal-safe C++ handler; every language drains on a single SIGTERM (17/17).
  • demo-25: write-back answers 202, upserts, and retries failed flushes with a bound (29/29).

Site: codetabs aligned with the examples (valet key, claim check, bulkhead, write-back, serdes, Apicurio v3 API, shutdown, readiness), vendor-neutral wording, figure fixes.

Validation: validate_site.py 0 errors, voice ban tier 0, deck_fit 0 flags, colour and caps audits 0 on every deck; watch-tier survivors recorded in _plans/s12-manifest/README.md.

Next: S13 (idiomatic persistence: Panache, Spring Data JPA, EF Core).

@patterncatalyst
patterncatalyst merged commit c5d10c2 into main Oct 12, 2026
29 checks passed
@patterncatalyst
patterncatalyst deleted the docs/deck-refresh branch October 12, 2026 18:31
patterncatalyst added a commit that referenced this pull request Oct 23, 2026
* docs(plan): S12 deck refresh plan, manifest and validation ledger

* feat(scripts): deck toolkit (text copy, in-place edits, render, fit check)

* ci: gate the deck text copies and scan them for voice, positional terms and stale stack (S12)

* fix(demo-01): readiness answers 503 when the database is down

* fix(demo-21): async-signal-safe SIGTERM handling that drains on a single signal

* fix(demo-25): write-back answers 202, upserts and retries failed flushes

* fix(scripts): one-workshop guards ignore the MCP doc-search containers

* docs(site): align codetabs and figures with the examples; vendor-neutral wording (S12)

* docs(deck): shared edits and figure sources (S12)

* docs(deck): refresh the K8s environment access policies deck (S12)

* docs(deck): rework the network policy advisory to upstream Kubernetes and open source (S12)

* docs(deck): refresh the Python deck (S12)

* docs(deck): refresh the Quarkus deck (S12)

* docs(deck): refresh the Spring deck (S12)

* docs(deck): refresh the .NET deck (S12)

* docs(deck): refresh the Go deck (S12)

* docs(deck): refresh the C++ deck (S12)

* docs: describe the refreshed decks and the in-place method (S12)

* docs(plan): S12 done; S13 idiomatic persistence next
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