Repository navigation
docs(appendix-s): example 05 on OpenShift Local (S10) - #68
Merged
Merged
Conversation
…nd OpenShift scripts
…, verify matrix, teardown)
… oc command, stable-cluster wait
… harden setup waits
patterncatalyst
added a commit
that referenced
this pull request
Oct 12, 2026
* chore(ci): vendor the professional-voice scanner and scope wrapper (S11)
Adds scripts/voice/{scan.sh,patterns.tsv} byte-identical from lgtm-skills 50b4c08 with a provenance README, the scope wrapper scripts/voice-scan.sh, and the S11 plan. Marks S10 done (PR #68).
* docs: professional-voice pass, appendices R-S, example pages and READMEs (S11)
ALL-CAPS lowercased in two headings and one README; README points at internal planning notes. Kept hits are literal minikube/OpenShift subjects, result tables, counts and identifiers.
* docs(§5): professional-voice pass, chapter 05 (S11)
16 ban-tier phrases rewritten (genuinely, deliberately, on purpose, for free, honest, load-bearing, earns its keep, the rest of this chapter); ALL-CAPS labels lowercased in 05-sourcing-vs-streaming; 05-checkpoint-recovery label and alt kept in step.
* docs: professional-voice pass, appendices I-K (S11)
Ban-tier phrases rewritten in Appendices I, J and K (earn its place, genuinely, deliberately, candid, for free, arguably); diagram labels for 22-hop-cost, 22-east-west, 22-l7-layers and 24-monolith-unit kept in step with their alt text; heading 'What the .NET cloud-native story lacks' (no inbound anchors).
* docs: professional-voice pass, chapters 00-13 (S11)
Ban-tier phrases rewritten across chapters 00-13; watch-tier hits fixed except one chapter opener. Headings 'How the book is ordered' and 'How correlation works' (no inbound anchors). Labels in 04-cqrs, 04-db-per-service, 08-four-planes, 12-claim-check and 13-antipatterns-grid kept in step with their alt text.
* docs: professional-voice pass, appendices L-Q and glossary (S11)
Ban-tier phrases rewritten in Appendices L-P; headings "When not to cache" and "what dotnet build produces" (no inbound anchors). Labels in 25-gray-failure, 25-istio-resilience and 27-ci-gate updated; the 27-ci-gate generator string kept in step.
* docs: professional-voice pass, appendices A-H (S11)
Ban-tier phrases rewritten in Appendices A-H; heading "Three paradigms and their mental models" (no inbound anchors). Labels in 17-saga-state, 18-rest-errors, 19-strategic-ddd, 20-cynefin-coupling and 21-shutdown-sequence kept in step with their alt text.
* ci(content): enforce the professional-voice ban tier in content-ok (S11)
content.yml runs scripts/voice-scan.sh (fails on any ban-tier phrase) and logs all-tier totals; CLAUDE.md documents the gate and its scope; plan records the per-batch ledgers.
* chore(ci): re-vendor the voice scanner from lgtm-skills a335007 (S11)
* fix(ci): scan only the given paths in voice-scan.sh; label examples excerpt paths (S11)
* docs: voice repair round 1 (S11)
Validator findings: grammar fix in Appendix K, 'rest of the appendix' and summary markers rewritten, 'deliberate' triaged (kept where it names a planned stage), claims restored to their original strength (caching payoff, random eviction, Minimal built-in DI), 'quietly fails' restored on the 04-db-per-service label, 27-ci-gate label 'in CI as they do locally', positional alt in chapter 04.
* chore(s11): record per-file voice evidence and repair round 1
* fix(s11): recheck nits (sticky-sessions label, Appendix L opener, wrapper path resolution)
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Section S10 of the modernization plan: Appendix S runs Example 05 on OpenShift Local (CRC 2.64.0, OpenShift 4.22.14, Kubernetes 1.35.6) in five languages (Spring Boot, Quarkus, .NET, Python, Go).
What changes
examples/05-event-driven/openshift/: kustomize overlays that reuse../k8s(Routes instead of NodePorts, internal-registry images,imagePullPolicy: Always), AMQ Streams operator pinned toamqstreams.v3.2.1-14with Manual approval in its own namespace, Kafka 4.2.0 (AMQ Streams 3.2 ships Kafka 4.1 and 4.2),rhel10/postgresql-18, otel-lgtm under restricted-v2 with emptyDir mounts.setup-crc.sh,build-push-images.sh(skopeo push; the registry token stays in shell memory, never in a file or argv),deploy.sh,verify-matrix.sh,teardown.sh(removes only what it installed, refuses or keeps on foreign Kafka items, ends incrc stop, nevercrc delete). Every oc call uses--context crc-admin; the kubeconfig current-context is never changed.k8s/images.shshared build table; CI k8s job renamed "Kubernetes and OpenShift manifests" and validates the OpenShift renders (kubeconform with the pinned CRDs-catalog openshift schemas); selector routesopenshift/changes._docs/32-appendix-s-openshift-local.md) with figures S.1 and S.2; index and README list appendices A–S; prerequisites, CLAUDE.md and READMEs updated.Verification
verify.sh10 passed, 0 failed; linked traces (order-service, shipping-consumer, notification-consumer) in Tempo; every pod onrestricted-v2; HTTP redirects to HTTPS; Grafana healthy via its Route.~/.kube/configunchanged._plans/s10-openshift-local-plan.md.