docs(P71): polish leadership decks — action headlines, trim, 6 new diagrams (v1.13)
Polish both leadership decks (how-the-platform-works + the-developer-experience) across all 4 pipeline layers (source md, marp, html, talking points). Story-arc restructure (per storytelling best practices): - Intro ~10% / Body ~80% / Conclusion ~10%; 3-5 body points per deck - One idea per slide; action headlines replace category names - Before/after 2-slide sequence (problem -> north star) on platform deck - Main 10 slides kept; detail pushed to expanded appendix (8 + 7) Word reduction + natural flow: - Remove all <em class="story"> transition lines (flow carried by headlines) - Bullets <= 12 words, 3-4 per main slide (was 5-6) - Cut parentheticals, sub-clauses, redundant restatements Design + visuals: - Larger fonts: body 22 -> 26px, h1 34 -> 40px, h2 26 -> 32px, blockquote 20 -> 24px - 6 new mermaid diagrams -> PNGs: - platform-works-02-frictions (2x2 quadrant) - platform-works-03-north-star (before/after) - platform-works-07-zero-trust (OIDC + ABAC flow) - developer-experience-05-catalog (primitives -> modules) - developer-experience-07-decommission (6-node gate flow) - developer-experience-08-semver (floating/pinned/major timeline) - At most 1 diagram per main slide; no diagrams on title/conclusion - High contrast preserved, no animations, maturity badges intact Verify: - Marp renders both decks clean (HTML re-rendered, committed) - Talking-points sections == Marp slide count per deck - No stale "deploy-unverified" claims (only closed-status disclosure) - 522 tests pass (no code touched; only docs/presentations/ files changed) - 22/22 Verified framing preserved verbatim from v1.12 ---ci--- project: acdl phase: 71 milestone: v1.13 status: complete ---/ci---
This commit is contained in:
Jon Chery
@@ -0,0 +1,25 @@
|
||||
%%{init: {"theme": "base", "themeVariables": {"primaryColor": "#1B1B1B", "primaryBorderColor": "#D6002A", "primaryTextColor": "#fff", "secondaryColor": "#fff", "secondaryBorderColor": "#D6002A", "secondaryTextColor": "#1B1B1B", "tertiaryColor": "#F0F0F0", "clusterBkg": "#F0F0F0", "lineColor": "#1B1B1B", "fontFamily": "\"Akkurat Pro\", \"Helvetica Neue\", \"Arial\", sans-serif"}}}%%
|
||||
|
||||
flowchart LR
|
||||
subgraph PRIM ["Primitives"]
|
||||
direction TB
|
||||
P1["S3"]
|
||||
P2["VPC"]
|
||||
P3["ECS"]
|
||||
P4["IAM"]
|
||||
P5["ALB"]
|
||||
P6["ECR"]
|
||||
P7["CloudFront"]
|
||||
P8["WAF"]
|
||||
P9["RDS"]
|
||||
end
|
||||
subgraph MOD ["Modules — composed patterns"]
|
||||
direction TB
|
||||
M1["Static site\nCDN + WAF + S3"]
|
||||
M2["Microservice\nVPC + ECS + ALB + ECR"]
|
||||
end
|
||||
PRIM --> MOD
|
||||
classDef accent fill:#1B1B1B,color:#fff,stroke:#D6002A,stroke-width:2px
|
||||
classDef supporting fill:#fff,color:#1B1B1B,stroke:#D6002A,stroke-width:1px
|
||||
class P1,P2,P3,P4,P5,P6,P7,P8,P9 supporting
|
||||
class M1,M2 accent
|
||||
@@ -0,0 +1,14 @@
|
||||
%%{init: {"theme": "base", "themeVariables": {"primaryColor": "#1B1B1B", "primaryBorderColor": "#D6002A", "primaryTextColor": "#fff", "secondaryColor": "#fff", "secondaryBorderColor": "#D6002A", "secondaryTextColor": "#1B1B1B", "tertiaryColor": "#F0F0F0", "clusterBkg": "#F0F0F0", "lineColor": "#1B1B1B", "fontFamily": "\"Akkurat Pro\", \"Helvetica Neue\", \"Arial\", sans-serif"}}}%%
|
||||
|
||||
flowchart LR
|
||||
A["Validate CR\n(CMDB)"]
|
||||
B["Disable\nprevent_destroy"]
|
||||
C["SRE\napprove"]
|
||||
D["Zero counts\n+ destroy"]
|
||||
E["SRE\napprove"]
|
||||
F["Key enters\ngrace window"]
|
||||
A --> B --> C --> D --> E --> F
|
||||
classDef accent fill:#1B1B1B,color:#fff,stroke:#D6002A,stroke-width:2px
|
||||
classDef supporting fill:#fff,color:#1B1B1B,stroke:#D6002A,stroke-width:1px
|
||||
class A,B,D,F supporting
|
||||
class C,E accent
|
||||
@@ -0,0 +1,28 @@
|
||||
%%{init: {"theme": "base", "themeVariables": {"primaryColor": "#1B1B1B", "primaryBorderColor": "#D6002A", "primaryTextColor": "#fff", "secondaryColor": "#fff", "secondaryBorderColor": "#D6002A", "secondaryTextColor": "#1B1B1B", "tertiaryColor": "#F0F0F0", "clusterBkg": "#F0F0F0", "lineColor": "#1B1B1B", "fontFamily": "\"Akkurat Pro\", \"Helvetica Neue\", \"Arial\", sans-serif"}}}%%
|
||||
|
||||
flowchart LR
|
||||
subgraph FLOAT ["@v1.12 — floating MAJOR+MINOR"]
|
||||
direction LR
|
||||
F1["v1.12.0"]
|
||||
F2["v1.12.1"]
|
||||
F3["v1.12.2"]
|
||||
F1 --> F2 --> F3
|
||||
end
|
||||
subgraph PIN ["@v1.12.2 — pinned exact"]
|
||||
direction LR
|
||||
P1["v1.12.2"]
|
||||
P2["v1.12.2"]
|
||||
P3["v1.12.2"]
|
||||
P1 --> P2 --> P3
|
||||
end
|
||||
subgraph MAJ ["@v1 — float MAJOR only"]
|
||||
direction LR
|
||||
M1["v1.12.0"]
|
||||
M2["v1.13.0"]
|
||||
M3["v1.14.0"]
|
||||
M1 --> M2 --> M3
|
||||
end
|
||||
classDef accent fill:#1B1B1B,color:#fff,stroke:#D6002A,stroke-width:2px
|
||||
classDef supporting fill:#fff,color:#1B1B1B,stroke:#D6002A,stroke-width:1px
|
||||
class F1,F2,F3,M1,M2,M3 accent
|
||||
class P1,P2,P3 supporting
|
||||
@@ -0,0 +1,19 @@
|
||||
%%{init: {"theme": "base", "themeVariables": {"primaryColor": "#1B1B1B", "primaryBorderColor": "#D6002A", "primaryTextColor": "#fff", "secondaryColor": "#fff", "secondaryBorderColor": "#D6002A", "secondaryTextColor": "#1B1B1B", "tertiaryColor": "#F0F0F0", "clusterBkg": "#F0F0F0", "lineColor": "#1B1B1B", "fontFamily": "\"Akkurat Pro\", \"Helvetica Neue\", \"Arial\", sans-serif"}}}%%
|
||||
|
||||
flowchart LR
|
||||
subgraph ROW1 [" "]
|
||||
direction LR
|
||||
A["Cognitive load\nauthoring infra correctly"]
|
||||
B["Operational work\nmerged → running"]
|
||||
end
|
||||
subgraph ROW2 [" "]
|
||||
direction LR
|
||||
C["Red tape\ntickets, approvals, handoffs"]
|
||||
D["Scalability\nthroughput without headcount"]
|
||||
end
|
||||
A ~~~ B
|
||||
C ~~~ D
|
||||
A ~~~ C
|
||||
B ~~~ D
|
||||
classDef accent fill:#1B1B1B,color:#fff,stroke:#D6002A,stroke-width:2px
|
||||
class A,B,C,D accent
|
||||
@@ -0,0 +1,23 @@
|
||||
%%{init: {"theme": "base", "themeVariables": {"primaryColor": "#1B1B1B", "primaryBorderColor": "#D6002A", "primaryTextColor": "#fff", "secondaryColor": "#fff", "secondaryBorderColor": "#D6002A", "secondaryTextColor": "#1B1B1B", "tertiaryColor": "#F0F0F0", "clusterBkg": "#F0F0F0", "lineColor": "#1B1B1B", "fontFamily": "\"Akkurat Pro\", \"Helvetica Neue\", \"Arial\", sans-serif"}}}%%
|
||||
|
||||
flowchart LR
|
||||
subgraph TODAY ["Today"]
|
||||
direction TB
|
||||
A["Merged change"]
|
||||
B["Waits in queue"]
|
||||
C["Ticket + approvals"]
|
||||
D["Manual promotion"]
|
||||
A --> B --> C --> D
|
||||
end
|
||||
subgraph ACDL ["With ACDL"]
|
||||
direction TB
|
||||
E["Declare intent\n(one YAML contract)"]
|
||||
F["Platform delivers\nsafely, autonomously"]
|
||||
G["Traceable to\nhuman attestation"]
|
||||
E --> F --> G
|
||||
end
|
||||
TODAY -.before.-> ACDL
|
||||
classDef accent fill:#1B1B1B,color:#fff,stroke:#D6002A,stroke-width:2px
|
||||
classDef supporting fill:#fff,color:#1B1B1B,stroke:#D6002A,stroke-width:1px
|
||||
class A,B,C,D supporting
|
||||
class E,F,G accent
|
||||
@@ -0,0 +1,12 @@
|
||||
%%{init: {"theme": "base", "themeVariables": {"primaryColor": "#1B1B1B", "primaryBorderColor": "#D6002A", "primaryTextColor": "#fff", "secondaryColor": "#fff", "secondaryBorderColor": "#D6002A", "secondaryTextColor": "#1B1B1B", "tertiaryColor": "#F0F0F0", "clusterBkg": "#F0F0F0", "lineColor": "#1B1B1B", "fontFamily": "\"Akkurat Pro\", \"Helvetica Neue\", \"Arial\", sans-serif"}}}%%
|
||||
|
||||
flowchart LR
|
||||
A["Consumer repo\n(no credentials)"]
|
||||
B["OIDC federation\nshort-lived token"]
|
||||
C["ABAC session policy\nrepo identity + tags"]
|
||||
D["Tagged resources\nonly"]
|
||||
A --> B --> C --> D
|
||||
classDef accent fill:#1B1B1B,color:#fff,stroke:#D6002A,stroke-width:2px
|
||||
classDef supporting fill:#fff,color:#1B1B1B,stroke:#D6002A,stroke-width:1px
|
||||
class A,D supporting
|
||||
class B,C accent
|
||||
Reference in New Issue
Block a user