From 8e5c3f7a0cf0a8504054b5bdece4fe31b9a2d7e3 Mon Sep 17 00:00:00 2001 From: lex00 <121451605+lex00@users.noreply.github.com> Date: Tue, 17 Nov 2026 11:31:49 -0700 Subject: [PATCH] docs(site): name things in headings, link product marks on the operation cards --- src/components/CompareTeaser.astro | 2 +- src/components/Picker.astro | 2 +- src/components/Room.astro | 4 ++-- src/components/StateOp.astro | 21 ++++++++++++------- .../docs/compare/coordinating-changes.mdx | 2 +- src/content/docs/security.md | 2 +- src/content/docs/tools.mdx | 2 +- src/data/arenas.mjs | 2 +- src/data/compare-choudoufu-state.mjs | 2 +- src/data/compare-plunge-state.mjs | 2 +- src/data/compare-pulumi-platforms.mjs | 2 +- 11 files changed, 25 insertions(+), 18 deletions(-) diff --git a/src/components/CompareTeaser.astro b/src/components/CompareTeaser.astro index 01ecb5e..34e71b6 100644 --- a/src/components/CompareTeaser.astro +++ b/src/components/CompareTeaser.astro @@ -18,7 +18,7 @@ const rows = [ { q: 'The plan you need for all of it', cells: Object.fromEntries(VENDORS.map((v) => [v.id, ['', need(v.id)]])) }, { q: 'How you pay', cells: row('basics', 'No license or usage fees') }, { q: 'Your pipeline, if you leave', cells: row('leaving', 'Your pipeline leaves with you') }, - { q: 'What one apply locks', cells: row('concurrency', 'One apply locks less than a whole root') }, + { q: "One apply's lock", cells: row('concurrency', 'One apply locks less than a whole root') }, ]; const ours = VENDORS[0].id; --- diff --git a/src/components/Picker.astro b/src/components/Picker.astro index 652574e..a28c72c 100644 --- a/src/components/Picker.astro +++ b/src/components/Picker.astro @@ -25,7 +25,7 @@ const [tile] = tiles;
-

What I do

+

How we help

diff --git a/src/components/Room.astro b/src/components/Room.astro index 0ac0740..3b84025 100644 --- a/src/components/Room.astro +++ b/src/components/Room.astro @@ -16,7 +16,7 @@ const r = room(Astro.props.id); {r.compare && }
-

What I do

+

How we help

    {r.does.map((d: string) =>
  • {d}
  • )}
@@ -26,7 +26,7 @@ const r = room(Astro.props.id);
-

What you can check now

+

Check it now

All of it is open source, so you can read or run it before writing to me.

    {r.check.map((l: { label: string; href: string }) =>
  • {l.label}
  • )}
diff --git a/src/components/StateOp.astro b/src/components/StateOp.astro index f4f75cc..ec8d210 100644 --- a/src/components/StateOp.astro +++ b/src/components/StateOp.astro @@ -150,13 +150,19 @@ const X = (x, y, s = 7) => `M${x - s} ${y - s} L${x + s} ${y + s} M${x + s} ${y boundaries by label - - choudoufu - - plunge - - - chant + + + choudoufu + + + + plunge + + + + + chant + {edgePath @@ -228,6 +234,7 @@ const X = (x, y, s = 7) => `M${x - s} ${y - s} L${x + s} ${y + s} M${x + s} ${y .op text { font-family: var(--sl-font, system-ui, sans-serif); } .op-name { font-size: 16px; font-weight: 700; fill: var(--sl-color-white); } .op-logo-name { font-size: 13px; font-weight: 600; fill: var(--sl-color-gray-2); } + .op-logos a:hover .op-logo-name, .op-logos a:focus-visible .op-logo-name { fill: var(--sl-color-white); text-decoration: underline; } .op-pixel { image-rendering: pixelated; } :global([data-theme='light']) .op .op-on-dark { display: none; } :global(:root:not([data-theme='light'])) .op .op-on-light { display: none; } diff --git a/src/content/docs/compare/coordinating-changes.mdx b/src/content/docs/compare/coordinating-changes.mdx index a5c7e10..c0db117 100644 --- a/src/content/docs/compare/coordinating-changes.mdx +++ b/src/content/docs/compare/coordinating-changes.mdx @@ -13,7 +13,7 @@ import * as pl from '../../../data/compare-plunge-state.mjs';

Coordinating applies comes down to ownership and boundaries, and the way you implement them shapes every operation below.

- + diff --git a/src/content/docs/security.md b/src/content/docs/security.md index fd6fe2c..6eb69bc 100644 --- a/src/content/docs/security.md +++ b/src/content/docs/security.md @@ -19,7 +19,7 @@ You create each grant for the audit and remove it when we finish. If you would rather grant nothing, we run the same tools on your machine over a screen share and you keep every output. -## What the tools can do with it +## The calls the tools make The audit runs [behold](https://intentius.io/behold/) and [chant](https://intentius.io/chant/). Both are open source, so your team can read the code that touches your accounts. diff --git a/src/content/docs/tools.mdx b/src/content/docs/tools.mdx index a876496..ff9c778 100644 --- a/src/content/docs/tools.mdx +++ b/src/content/docs/tools.mdx @@ -68,6 +68,6 @@ Local stand-ins so the tools run without a cloud account. [mudflaps](https://git ## Questions -### What has been checked, and how? +### Evidence for each tool The evidence pages live in each tool's repository and are updated with every release. See [choudoufu](https://github.com/INTENTIUS/choudoufu/blob/main/EVIDENCE.md) and [plunge](https://github.com/INTENTIUS/plunge/blob/main/EVIDENCE.md) for the two forks, and [plywood](https://github.com/INTENTIUS/plywood/blob/main/EVIDENCE.md) with [terragucci](https://github.com/INTENTIUS/terragucci/blob/main/EVIDENCE.md) for the two CI tools. diff --git a/src/data/arenas.mjs b/src/data/arenas.mjs index 2884391..e6c0bb2 100644 --- a/src/data/arenas.mjs +++ b/src/data/arenas.mjs @@ -245,7 +245,7 @@ export const ARENAS = [ ], }, { - id: 'attest', title: 'What the attestation covers', + id: 'attest', title: 'The attestation\'s scope', blurb: "A vendor's SOC 2 covers its own service, not your estate.", rows: [ { q: 'No third party added to your audit scope', diff --git a/src/data/compare-choudoufu-state.mjs b/src/data/compare-choudoufu-state.mjs index d185763..6ba5068 100644 --- a/src/data/compare-choudoufu-state.mjs +++ b/src/data/compare-choudoufu-state.mjs @@ -51,7 +51,7 @@ export const ARENAS = [ { id: 'concurrency', title: 'Two changes at once', rows: [ - { q: 'What one apply holds', + { q: 'Held by one apply', cdf: ['good', 'each resource is its own record', `${C}/how-it-works/locking/`], tf: ['warn', 'the whole state file', `${H}/language/state/locking`] }, { q: 'Applies on different resources', diff --git a/src/data/compare-plunge-state.mjs b/src/data/compare-plunge-state.mjs index 7a7aa96..b564038 100644 --- a/src/data/compare-plunge-state.mjs +++ b/src/data/compare-plunge-state.mjs @@ -52,7 +52,7 @@ export const ARENAS = [ { id: 'concurrency', title: 'Two changes at once', rows: [ - { q: 'What one update holds', + { q: 'Held by one update', pl: ['good', 'each record is its own write', `${P}/how-it-works/concurrency/`], pu: ['warn', 'the stack lock', S] }, { q: 'Updates on different resources', diff --git a/src/data/compare-pulumi-platforms.mjs b/src/data/compare-pulumi-platforms.mjs index 393a953..a7f792c 100644 --- a/src/data/compare-pulumi-platforms.mjs +++ b/src/data/compare-pulumi-platforms.mjs @@ -222,7 +222,7 @@ export const ARENAS = [ ], }, { - id: 'attest', title: 'What the attestation covers', + id: 'attest', title: 'The attestation\'s scope', blurb: "A vendor's SOC 2 covers its own service, not your estate.", rows: [ { q: 'No third party added to your audit scope',