From 966a1e5e2dda3878e72e341fadf3be0860e8c09c Mon Sep 17 00:00:00 2001 From: Claude Date: Wed, 22 Jul 2026 06:05:28 +0000 Subject: [PATCH 1/2] Add SILO white paper and companion technical note links Links the SILO white paper on GitHub and a new companion technical note (published as a research collection entry) from the "Dive Deeper" section of the SILO standards page. --- docs/pages/research.md | 4 ++ docs/pages/standards.md | 9 ++++ .../en/silo-companion-technical-note.md | 43 +++++++++++++++++++ src/pages/standards/silo/index.astro | 25 ++++++++++- 4 files changed, 80 insertions(+), 1 deletion(-) create mode 100644 src/content/research/en/silo-companion-technical-note.md diff --git a/docs/pages/research.md b/docs/pages/research.md index c49c2eb7..b46ec6a0 100644 --- a/docs/pages/research.md +++ b/docs/pages/research.md @@ -83,3 +83,7 @@ Same as articles — setting `published: false` hides from listings, shows a dra ## Also appears on Research papers are also shown on the [Policy & Research page](policy.md) in hardcoded cards (4 publications) — those are separate from this content collection and require a code change to update. + +## Cross-links from standards pages + +A standards page can link to a research entry as a supporting resource. For example, the [SILO standards page](standards.md#silos-dive-deeper-resource-links) links to `silo-companion-technical-note.md` (`/policy/research/silo-companion-technical-note/`) as a companion to the external SILO white paper. There is no automatic cross-link in either direction beyond the `workingGroup` slug — the standards page must link to the research entry's URL explicitly. diff --git a/docs/pages/standards.md b/docs/pages/standards.md index 4f7c8f36..03fcda7e 100644 --- a/docs/pages/standards.md +++ b/docs/pages/standards.md @@ -70,6 +70,15 @@ Currently three hardware standards have dedicated pages: All three appear under the Hardware section in the nav (`src/lib/nav-items.ts`, SILO listed first) and in the standards index (`src/pages/standards/index.astro`, `standardDefs` array). Open19 and SILO both reuse WDPC's icon/illustration assets as placeholders — dedicated SVGs should be added to `public/assets/standards/open19/` and `public/assets/standards/silo/` once available. Articles tagged `"open19"` / `"silo"` will automatically appear in each page's carousel. +### SILO's "Dive Deeper" resource links + +The SILO page's "Dive Deeper" section (`id="resources"`) is a hardcoded array of external resource links (repo, specification, working group), plus: + +- **Read the White Paper** — links out to the SILO white paper on GitHub (`SILO_WHITEPAPER` const in the page frontmatter). +- **Companion Technical Note** — links to the internal companion note detailing the internal interoperability layer, published as a [research collection entry](research.md) at `/policy/research/silo-companion-technical-note/` (`SILO_COMPANION_NOTE` const). + +To update either link, edit the corresponding `const` at the top of `src/pages/standards/silo/index.astro`. Entries default to opening external links in a new tab (`target="_blank"`); set `external: false` on an entry to link internally in the same tab, as the companion note entry does. + ## Lifecycle Stages The lifecycle stage badge comes from the `Lifecycle Stage` field in Notion's PWCIs database. On the standards overview page (`/standards/`), "Learn more" links are hidden for Proposal/Pre-proposal stages. diff --git a/src/content/research/en/silo-companion-technical-note.md b/src/content/research/en/silo-companion-technical-note.md new file mode 100644 index 00000000..62d92b2f --- /dev/null +++ b/src/content/research/en/silo-companion-technical-note.md @@ -0,0 +1,43 @@ +--- +title: "Companion Technical Note - Completing the Architecture: The Internal Interoperability Layer" +date: 2026-07-22 +published: true +status: published +type: paper +summary: > + A companion note to the SILO white paper "Bridging the Sustainability Gap," clarifying how the internal interoperability layer complements the external, grid-facing interface to form a complete, deployable specification. +workingGroup: silo +tags: ["silo", "hardware-standards"] +--- + +## Purpose + +The white paper *Bridging the Sustainability Gap* describes an open specification that enables data centres to receive real-time grid signals and optimise their operation based on sustainability objectives. + +This companion note clarifies the role of the internal interoperability layer described in the original technical proposal. The white paper focuses on the external interface between the data centre and the grid, while the technical proposal defines the internal semantics and interoperability capabilities that make those interactions practical in heterogeneous, multi-vendor environments. + +## Architecture + +The two documents describe complementary components of the same architecture: + +| Layer | +|---| +| **Grid Operator / External Signals**
Renewable mix · Carbon intensity · Demand constraints | +| ↕ | +| **External Interface Specification (White Paper)**
Grid signal ingestion · Power source awareness · ESG output | +| ↕ | +| **Internal Interoperability Layer (This Proposal) — NEW**
Semantic normalization · Vendor-neutral translation · Data contracts | +| ↕ | +| **Existing WDPC Data Bus + Rack & Sensing + Facility Infrastructure** | + +The internal layer sits between the existing WDPC data bus and the external interface, providing the semantic normalization and vendor-neutral translation that allows diverse systems to feed clean, consistent data upward — on which the external interface's grid-responsive decisions depend. + +### Scope + +| Internal Interoperability Layer (Proposal) | External Interface (White Paper) | +|---|---| +| Cross-system data normalization within the DC | DC ↔ Grid communication | +| Semantic model & vendor-neutral translation | Grid signal ingestion & ESG output | +| Enables: reliable external signals & responses | Requires: unified internal data | + +Neither component is sufficient alone. The external interface without the internal layer works only in homogeneous, single-vendor environments. Together they form a complete, deployable specification. diff --git a/src/pages/standards/silo/index.astro b/src/pages/standards/silo/index.astro index 108b0bc2..cc67a118 100644 --- a/src/pages/standards/silo/index.astro +++ b/src/pages/standards/silo/index.astro @@ -41,6 +41,8 @@ const carouselArticles = (await getCollection("articles", (a) => a.data.publishe const GSF_SILO_REPO = "https://github.com/Green-Software-Foundation/silo"; const HARDWARE_WG = "https://github.com/Green-Software-Foundation/hardware-standards-wg"; const MEMBERSHIP_CTA = "/membership/"; +const SILO_WHITEPAPER = "https://github.com/Green-Software-Foundation/sci-policy-and-legislation-alignment-white-paper-series/blob/main/whitepapers/Interoperability%20Layer%20for%20Real-Time%20Data%20Centre%20Sustainability%20Optimisation.md"; +const SILO_COMPANION_NOTE = "/policy/research/silo-companion-technical-note/"; --- (
@@ -375,7 +393,12 @@ const MEMBERSHIP_CTA = "/membership/";

{feature.description}

- + {feature.buttonText} → From dfe75c073c97e022853386c31d7db6c17548f5cf Mon Sep 17 00:00:00 2001 From: Claude Date: Wed, 22 Jul 2026 06:22:07 +0000 Subject: [PATCH 2/2] Move SILO white paper and companion note links to hero CTAs Places both links in the hero button row next to "Visit the Directory" / "Back to Standards" (matching the intended location) instead of the separate "Dive Deeper" resources section. --- docs/pages/research.md | 2 +- docs/pages/standards.md | 8 ++++---- src/pages/standards/silo/index.astro | 25 +++---------------------- 3 files changed, 8 insertions(+), 27 deletions(-) diff --git a/docs/pages/research.md b/docs/pages/research.md index b46ec6a0..f1967778 100644 --- a/docs/pages/research.md +++ b/docs/pages/research.md @@ -86,4 +86,4 @@ Research papers are also shown on the [Policy & Research page](policy.md) in har ## Cross-links from standards pages -A standards page can link to a research entry as a supporting resource. For example, the [SILO standards page](standards.md#silos-dive-deeper-resource-links) links to `silo-companion-technical-note.md` (`/policy/research/silo-companion-technical-note/`) as a companion to the external SILO white paper. There is no automatic cross-link in either direction beyond the `workingGroup` slug — the standards page must link to the research entry's URL explicitly. +A standards page can link to a research entry as a supporting resource. For example, the [SILO standards page](standards.md#silo-hero-ctas--white-paper-and-companion-technical-note) links to `silo-companion-technical-note.md` (`/policy/research/silo-companion-technical-note/`) as a companion to the external SILO white paper, from its hero CTA row. There is no automatic cross-link in either direction beyond the `workingGroup` slug — the standards page must link to the research entry's URL explicitly. diff --git a/docs/pages/standards.md b/docs/pages/standards.md index 03fcda7e..8f5ae7a6 100644 --- a/docs/pages/standards.md +++ b/docs/pages/standards.md @@ -70,14 +70,14 @@ Currently three hardware standards have dedicated pages: All three appear under the Hardware section in the nav (`src/lib/nav-items.ts`, SILO listed first) and in the standards index (`src/pages/standards/index.astro`, `standardDefs` array). Open19 and SILO both reuse WDPC's icon/illustration assets as placeholders — dedicated SVGs should be added to `public/assets/standards/open19/` and `public/assets/standards/silo/` once available. Articles tagged `"open19"` / `"silo"` will automatically appear in each page's carousel. -### SILO's "Dive Deeper" resource links +### SILO hero CTAs — White Paper and Companion Technical Note -The SILO page's "Dive Deeper" section (`id="resources"`) is a hardcoded array of external resource links (repo, specification, working group), plus: +The SILO page's hero `ctas` array (`src/pages/standards/silo/index.astro`) includes two links alongside "Visit the Directory" / "Back to Standards": -- **Read the White Paper** — links out to the SILO white paper on GitHub (`SILO_WHITEPAPER` const in the page frontmatter). +- **White Paper** — links out to the SILO white paper on GitHub (`SILO_WHITEPAPER` const at the top of the page frontmatter). - **Companion Technical Note** — links to the internal companion note detailing the internal interoperability layer, published as a [research collection entry](research.md) at `/policy/research/silo-companion-technical-note/` (`SILO_COMPANION_NOTE` const). -To update either link, edit the corresponding `const` at the top of `src/pages/standards/silo/index.astro`. Entries default to opening external links in a new tab (`target="_blank"`); set `external: false` on an entry to link internally in the same tab, as the companion note entry does. +To update either link, edit the corresponding `const` at the top of `src/pages/standards/silo/index.astro` and its entry in the `ctas` array passed to ``. ## Lifecycle Stages diff --git a/src/pages/standards/silo/index.astro b/src/pages/standards/silo/index.astro index cc67a118..c6e3ec2a 100644 --- a/src/pages/standards/silo/index.astro +++ b/src/pages/standards/silo/index.astro @@ -77,6 +77,8 @@ const SILO_COMPANION_NOTE = "/policy/research/silo-companion-technical-note/"; ctas={[ { text: "Visit the Directory", variant: "primary", href: "https://directory.greensoftware.foundation/projects/silo/" }, { text: "Back to Standards", variant: "outline", href: "/standards/" }, + { text: "White Paper", variant: "outline", href: SILO_WHITEPAPER }, + { text: "Companion Technical Note", variant: "outline", href: SILO_COMPANION_NOTE }, ]} imageSrc="/assets/standards/wdpc/hero-illustration.svg" imageAlt="SILO illustration" @@ -365,22 +367,6 @@ const SILO_COMPANION_NOTE = "/policy/research/silo-companion-technical-note/"; buttonText: "Join Working Group", badge: "GSF Members Only", }, - { - icon: "/assets/standards/wdpc/dive-icon-1.svg", - title: "Read the White Paper", - description: "Bridging the Sustainability Gap — the SILO white paper describing the external interface between data centres and the grid.", - buttonLink: SILO_WHITEPAPER, - buttonText: "Read the White Paper", - external: true, - }, - { - icon: "/assets/standards/wdpc/dive-icon-2.svg", - title: "Companion Technical Note", - description: "Completing the Architecture — a companion note detailing the internal interoperability layer that complements the white paper's external interface.", - buttonLink: SILO_COMPANION_NOTE, - buttonText: "Read the Companion Note", - external: false, - }, ].map((feature) => (
@@ -393,12 +379,7 @@ const SILO_COMPANION_NOTE = "/policy/research/silo-companion-technical-note/";

{feature.description}

- + {feature.buttonText} →