From 9fe29bb26e87fc5099153546fe4f9a37c0f3fad4 Mon Sep 17 00:00:00 2001 From: PatternCatalyst Date: Tue, 10 Nov 2026 22:56:14 -0500 Subject: [PATCH] site: bibliography tables with explicit column widths Markdown tables with five or six columns on the narrow page split into equal fixed columns, so titles, years and ISBNs wrapped mid-word. The tables are now HTML with colgroup widths: books keep Title, Author(s) and Year, with publisher and focus on a small line under the title; tables with a Link column link the first column instead. --- assets/css/site.css | 6 +++++ bibliography.md | 60 +++++++++++++++++++++++++-------------------- 2 files changed, 40 insertions(+), 26 deletions(-) diff --git a/assets/css/site.css b/assets/css/site.css index 02ebcb6..62d2ec2 100644 --- a/assets/css/site.css +++ b/assets/css/site.css @@ -755,3 +755,9 @@ pre code { pre { background: #f4f4f4; color: #000; border: 1px solid #ccc; } a { color: #000; text-decoration: underline; } } + +/* Bibliography: explicit column widths (colgroup) keep long titles and focus text readable */ +table.bib { table-layout: fixed; width: 100%; } +table.bib td small { display: block; margin-top: .5rem; color: var(--ink-muted, #6a6e73); line-height: 1.45; } +table.bib--books td:last-child { white-space: nowrap; } +table.bib :is(th, td) code { white-space: normal; overflow-wrap: anywhere; } diff --git a/bibliography.md b/bibliography.md index d845f2b..9fe2f18 100644 --- a/bibliography.md +++ b/bibliography.md @@ -15,35 +15,43 @@ you, these are where to go deeper. ## Books -| Title | Author(s) | Publisher | Focus | -|---|---|---|---| -| [*Data Mesh*](https://www.oreilly.com/library/view/data-mesh/9781492092384/) | Zhamak Dehghani | O'Reilly | The four principles, the data product as architectural quantum, federated governance | -| [*Designing Data-Intensive Applications*, 2nd ed.](https://www.oreilly.com/library/view/designing-data-intensive-applications/9781098119058/) | Martin Kleppmann & Chris Riccomini | O'Reilly | Reasoning about distributed systems built from independently-owned parts | -| [*Cloud Native Patterns*](https://www.manning.com/books/cloud-native-patterns) | Cornelia Davis | Manning | Packaging, runtime, and platform-provided concerns for services that double as data products | -| [*Cloud Native Anti-Patterns*](https://www.packtpub.com/en-us/product/cloud-native-anti-patterns-9781836200581) | Gerald Bachlmayr, Aiden Ziegelaar, Alan Blockley & Bojan Zivic | Packt | The failure modes the anti-patterns chapter maps | -| [*Kubernetes Patterns*](https://www.oreilly.com/library/view/-/9781098131678/) | Bilgin Ibryam & Roland Huß | O'Reilly | Container image and workload patterns behind the build, load, and deploy sequence | -| [*Platform Engineering on Kubernetes*](https://www.manning.com/books/platform-engineering-on-kubernetes) | Mauricio Salatino | Manning | The self-serve platform principle built out as an operating model | -| [*GitOps and Kubernetes*](https://www.manning.com/books/gitops-and-kubernetes) | Billy Yuen, Alexander Matyushentsev, Todd Ekenstam & Jesse Suen | Manning | Declarative delivery for the platform tier | -| [*Learning Domain-Driven Design*](https://www.oreilly.com/library/view/learning-domain-driven-design/9781098100124/) | Vlad Khononov | O'Reilly | Bounded contexts and domain ownership behind the service boundaries | -| [*Implementing Domain-Driven Design*](https://www.informit.com/store/implementing-domain-driven-design-9780133039894) | Vaughn Vernon | Addison-Wesley | Aggregates, events, and context mapping in code | + + + + + + + + + + + + + + +
TitleAuthor(s)
Data Mesh
O'Reilly. The four principles, the data product as architectural quantum, federated governance
Zhamak Dehghani
Designing Data-Intensive Applications, 2nd ed.
O'Reilly. Reasoning about distributed systems built from independently-owned parts
Martin Kleppmann & Chris Riccomini
Cloud Native Patterns
Manning. Packaging, runtime, and platform-provided concerns for services that double as data products
Cornelia Davis
Cloud Native Anti-Patterns
Packt. The failure modes the anti-patterns chapter maps
Gerald Bachlmayr, Aiden Ziegelaar, Alan Blockley & Bojan Zivic
Kubernetes Patterns
O'Reilly. Container image and workload patterns behind the build, load, and deploy sequence
Bilgin Ibryam & Roland Huß
Platform Engineering on Kubernetes
Manning. The self-serve platform principle built out as an operating model
Mauricio Salatino
GitOps and Kubernetes
Manning. Declarative delivery for the platform tier
Billy Yuen, Alexander Matyushentsev, Todd Ekenstam & Jesse Suen
Learning Domain-Driven Design
O'Reilly. Bounded contexts and domain ownership behind the service boundaries
Vlad Khononov
Implementing Domain-Driven Design
Addison-Wesley. Aggregates, events, and context mapping in code
Vaughn Vernon
## Primary documentation -| Project | Link | Used for | -|---|---|---| -| FastAPI | [fastapi.tiangolo.com](https://fastapi.tiangolo.com/) | The REST framework the services are built on | -| Strawberry GraphQL | [strawberry.rocks](https://strawberry.rocks/) | The GraphQL gateway's schema-first API | -| gRPC (Python) | [grpc.io/docs](https://grpc.io/docs/languages/python/) | The inventory-service synchronous contract | -| OpenTelemetry | [opentelemetry.io/docs](https://opentelemetry.io/docs/) | The metrics, traces, and logs signal model | -| Grafana | [grafana.com/docs](https://grafana.com/docs/) | Tempo for traces, Mimir/Prometheus for metrics | -| Apicurio Registry | [apicur.io/registry/docs](https://www.apicur.io/registry/docs/) | The schema registry for Avro contracts | -| OpenMetadata | [docs.open-metadata.org](https://docs.open-metadata.org/) | The catalog, discovery, and lineage | -| Istio | [istio.io/latest/docs](https://istio.io/latest/docs/) | The service mesh, mTLS, and progressive delivery | -| KEDA | [keda.sh/docs](https://keda.sh/docs/) | Event-driven and lag-based autoscaling | -| Strimzi | [strimzi.io/docs](https://strimzi.io/docs/) | The Kafka operator for the async backbone | -| Kubernetes | [kubernetes.io/docs](https://kubernetes.io/docs/) | Namespaces, RBAC, CRDs, admission control | -| minikube | [minikube.sigs.k8s.io/docs](https://minikube.sigs.k8s.io/docs/) | The local cluster, docker driver, containerd runtime | -| OpenShift Local (CRC) | [crc.dev](https://crc.dev/) | The OpenShift appendix | + + + + + + + + + + + + + + + + + + +
ProjectUsed for
FastAPIThe REST framework the services are built on
Strawberry GraphQLThe GraphQL gateway's schema-first API
gRPC (Python)The inventory-service synchronous contract
OpenTelemetryThe metrics, traces, and logs signal model
GrafanaTempo for traces, Mimir/Prometheus for metrics
Apicurio RegistryThe schema registry for Avro contracts
OpenMetadataThe catalog, discovery, and lineage
IstioThe service mesh, mTLS, and progressive delivery
KEDAEvent-driven and lag-based autoscaling
StrimziThe Kafka operator for the async backbone
KubernetesNamespaces, RBAC, CRDs, admission control
minikubeThe local cluster, docker driver, containerd runtime
OpenShift Local (CRC)The OpenShift appendix
These titles inform this site's coverage and rigor only. Nothing in these chapters or the runnable examples copies text or code from them.