Combined source repository for the public-service cloud architecture series (Chapters 1-3)
  • HTML 46.9%
  • Python 35.2%
  • Shell 14.7%
  • HCL 2.9%
  • Jinja 0.2%
Find a file
karsten 6f75b7adf8 docs(chapter-1): replace text from supplied document (#9)
Replace Chapter 1 with the supplied text and regenerate verified HTML, DOCX, and PDF release artefacts.
2026-09-11 12:16:39 +00:00
chapter-1 docs(chapter-1): replace text from supplied document (#9) 2026-09-11 12:16:39 +00:00
chapter-2 Update Chapter 2 opening and platform graphic 2026-09-09 08:53:26 +00:00
chapter-3 docs(chapter-3): finalize executable IaaS walkthrough (#4) 2026-09-07 09:53:27 +00:00
chapter-4 chapter 4: correct Argo CD expected output 2026-09-10 14:08:08 +00:00
README.md docs(chapter-4): add Cluster API OpenStack learning package 2026-09-07 18:45:37 +00:00

Content — public-service cloud architecture series

The single canonical repository for the series. Every chapter lives here, and every new chapter is added here. The series is ongoing: the chapter list below grows, it is not a fixed set.

Chapters

Chapter Source Subject Status
1 chapter-1/chapter-1.md Cloud for public services: choices, control and practical fit Released
2 chapter-2/chapter-2.md How cloud environments support dependable public services Released
3 chapter-3/chapter-3.md OpenStack and the IaaS technical baseline Working draft
4 chapter-4/chapter-4.md Kubernetes cluster lifecycle on OpenStack with Cluster API Release candidate
5 Complete platform capabilities and operation Planned
6 Workload deployment, including Information Mediator Planned

Further chapters follow. Numbering and the boundary between chapters are recorded with each chapter. Chapter 4's input and handoff are governed by chapter-4/SERIES_SCOPE.md. Chapter 3 was inserted, so historical references to the former Chapter 3 subject matter now refer to Chapter 4 and later historical chapter numbers shift by one.

Adding a chapter

One directory per chapter, named chapter-<n>/, following the existing convention:

  • chapter-<n>/chapter-<n>.md — canonical Markdown source, the review copy
  • chapter-<n>/graphics/ — accepted figures with their prompt and metadata audit records
  • chapter-<n>/release/ — rendered release assets (HTML / PDF / DOCX), generated after the control pass
  • chapter-<n>/scripts/ — release rendering script

Add the new chapter to the table above in the same change, and record its scope boundary against the preceding chapter.

Working rules

  • main is protected. No direct pushes; every change goes in through a pull request.
  • The Markdown source is the review copy. Release assets are regenerated after the control pass, never hand-edited.
  • A chapter is only marked Released once its audit, technical review and rendered-reader inspection have passed.

History

This repository replaces the former per-chapter repositories giga/chapter-1, giga/chapter-2 and giga/chapter-3, whose full content and commit history were merged in here. Those repositories are archived; no work happens in them. Chapter 1's source was renamed from cloud-computing-public-services-decision-document.md to chapter-1.md during the consolidation, and the references in chapter-1/SUMMARY.md and chapter-1/scripts/render_release.py were updated to match.