giga/content
2
0
Fork 0
Code Issues 1 Pull requests 2 Projects Releases Packages Wiki Activity Actions
Combined source repository for the public-service cloud architecture series (Chapters 1-3)
138 commits 10 branches 0 tags 2 GiB
  • Python 45.5%
  • HTML 41%
  • Shell 11.2%
  • HCL 2.1%
  • Jinja 0.1%
  • Other 0.1%
Find a file
Exact
Karsten Samaschke 7c503b47c7 Chapter 4: remove stored validation record 
Delete validation-evidence.json and its README links. The package check
now recomputes and prints the test, figure, page and link counts on each
run instead of comparing them with a stored file.
2026-10-02 11:02:34 +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 fix(chapter-3): close learning package acceptance gaps 2026-09-08 15:50:33 +00:00
chapter-4 Chapter 4: remove stored validation record 2026-10-02 11:02:34 +00:00
chapter-5 Chapter 5: remove internal review and validation records 2026-10-02 10:37:04 +00:00
README.md [DRAFT] Integrate Chapter 5 learning package and repair review blockers 2026-10-01 07:45:43 +00:00

README.md

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 chapter-5/chapter-5.md Build Management, LoadBalancer and two Spokes; use, scale and retire the platform Review candidate
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.