docs(decision-lineage): add SLIDES.md — Marp deck for leadership demos#103
Merged
haiyuan-eng-google merged 3 commits intoGoogleCloudPlatform:mainfrom May 1, 2026
Conversation
`examples/decision_lineage_demo/SLIDES.md` — a 21-slide Marp deck
that mirrors the 5-minute leadership pitch in DEMO_NARRATION.md and
the five EU-compliance questions in DEMO_QUESTIONS.md. Built with
Marp markdown so it ships as a single text file, version-controls
cleanly, and renders to PDF / PPTX / HTML via:
marp SLIDES.md --pdf
marp SLIDES.md --pptx
marp SLIDES.md --html
Structure (21 slides):
Title hero (EU AI Act framing + 7%-of-revenue penalty headline)
Why this matters now — regulatory + product pressure side-by-side
What we built — one-sentence pitch + pipeline diagram
Section 1 — The data behind today's demo
Six campaigns, six live agent runs (Nike Summer, Nike Winter,
Adidas, Puma, Reebok, Lululemon)
Three writers populate seven tables (BQ AA Plugin → SDK
AI.GENERATE → SDK SQL DML)
The graph the demo presents — 8 ads-domain node labels +
9 ads-domain edge labels (CampaignRun, AgentStep,
MediaEntity, PlanningDecision, DecisionOption,
DecisionCategory, OptionOutcome, DropReason; CampaignActivity,
NextStep, DecidedAt, ConsideredEntity, CampaignDecision,
WeighedOption, HasOutcome, RejectedBecause, InCategory)
Section 2 — Five regulator-shaped questions, answered live
Q1 Right to explanation (Art. 86 / GDPR Art. 22)
Q2 Bias / fairness audit (Art. 10, Art. 71)
Q3 Human-oversight trigger (Art. 14) — empty-result hero
Q4 Decision reproducibility (Art. 12, Art. 13)
Q5 Systemic / pattern audit (Art. 17, Art. 60)
Section 3 — What this unlocks
Three takeaways (queryable posture, generalizable schema,
composes with existing platform)
Compliance-anchor map (Q1-Q5 × EU AI Act / GDPR / DSA)
How fast can we ship this — phase timings, cost ("cents")
Section 4 — Where to go next
Open source pointers + bundle file map
Anticipated VP-level Q&A primer
Q&A hero closer
Theme: custom Marp theme on `gaia` base — Google Sans / Roboto
typography, #1a73e8 accent palette (matches Google Cloud brand),
gradient hero slides, code-block styling, two-column grids, stat
cards. Footer + pagination on body slides; off on lead slides.
README.md cross-references the new file from the docs-list and the
file map. Same 5-EU-question framing as DEMO_NARRATION.md and
DEMO_QUESTIONS.md so all three docs stay in lockstep.
…source Pre-rendered artifacts so reviewers can open the deck without installing Marp. SLIDES.html 316K — open in any browser SLIDES.pptx 5.6M — editable in Google Slides / Keynote / PowerPoint Both rendered from SLIDES.md with the Marp CLI: npx -y @marp-team/marp-cli@latest SLIDES.md --html npx -y @marp-team/marp-cli@latest SLIDES.md --html --pptx --no-stdin The deck source (SLIDES.md) gains a "regenerate" note in the opening HTML comment so future contributors know to refresh both artifacts after edits. README.md file map lists the rendered files. The pptx is binary and won't show readable diffs in PRs — a visible-diff regression caught in code review on SLIDES.md is the defense; the rendered artifacts are convenience copies.
6 tasks
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
2 participants
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.
Summary
Adds and polishes
examples/decision_lineage_demo/SLIDES.mdplus therendered
SLIDES.htmlandSLIDES.pptxartifacts.The deck is now framed around Bei's flow:
The result is a 33-page Marp deck for VP / Google Next-style
presentation use: executive framing, precise EU AI Act figures, explicit
customer-proof placeholders, five live audit questions, and a concrete
architecture appendix that shows exactly how the demo data becomes a
BigQuery property graph.
Why Marp
the demo bundle.
How to render
The deck intentionally uses inline HTML components, so render with
--html:Marp install:
npm install -g @marp-team/marp-clior use the VS Codeextension
marp-team.marp-vscode.Deck structure
AI.GENERATEBizNode MERGEOther changes
SLIDES.html: regenerated fromSLIDES.md.SLIDES.pptx: regenerated fromSLIDES.md.Test plan
marp examples/decision_lineage_demo/SLIDES.md --html -o examples/decision_lineage_demo/SLIDES.htmlmarp examples/decision_lineage_demo/SLIDES.md --html --pptx -o examples/decision_lineage_demo/SLIDES.pptxmarp examples/decision_lineage_demo/SLIDES.md --html --pdf -o /tmp/pr103_final.pdfgit diff --check