feat: new CG specification profiles by deniak · Pull Request #5482 · speced/respec

deniak · 2026-09-29T14:58:29Z

Introducing 2 new profiles CG-LIVING and CG-SNAPSHOT following the upcoming updates with the CG spec lifecycle. These profiles use different headers (see mockups) and rely on assets and metadata. The existing profiles CG-DRAFT and CG-FINAL remain untouched.
The new profiles come with 2 configuration options cgMaturity (draft, transferred or unmaintained) and transferredTo (only applies if cgMaturity = transferred)

Description of the new processing files:

src/w3c/templates/cg-headers.js builds the redesign headers for the 4 variants (draft, transferred, unmaintained and snapshot) and adds the different containers (with a data-cg-region attribute) that cg-metadata fills when the spec loads
src/w3c/cg-sections.js adds the "Get involved" and "Usage guidance" sections
src/w3c/cg-spec.js emits three new tags that cg-metadata relies on to fetch the appropriate metadata
src/w3c/templates/cg-sotd.js reduces the SotD to what the editors wrote (we do not have required paragraphs for the new profiles)

Some URLs are still subject to change so it's not ready to be merged.

- CG-LIVING - CG-SNAPSHOT Include the cgbgStatus and new CG assets (base.css, cg-spec.css, dark.css, cg-fixup.js and cg-metadata.js) for these new profiles. Introduce <meta> tags required by the new profiles. Run some validation.

…ata + introduce new boilerplates depending on the type of CG specs

…t index URL

…oscript>' parses its content as raw text

marcoscaceres · 2026-10-06T09:37:30Z

@sidvishnoi, do you mind reviewing this first if you have cycles. If you're busy, happy to dive in.

marcoscaceres · 2026-09-30T03:54:35Z

+const COMMUNITY = "https://www.w3.org/community/";
+const INCUBATION = "https://incubation.w3.org/";
+
+const chevron = () =>


this is only called once, so we can probably just inline it. Does this need any ARIA stuff?

addressed in 4a36ea9

marcoscaceres · 2026-10-06T09:34:48Z

@@ -0,0 +1,52 @@
+<!doctype html>


Not sure we should add this example at all to be honest.

marcoscaceres · 2026-10-06T09:36:02Z

+ * @param {string} noScriptText
+ * @param {"div" | "li"} as
+ */
+export function region(name, noScriptText, as = "div") {


Maybe more clear:

Suggested change

export function region(name, noScriptText, as = "div") {

export function region(name, noScriptText, elementName = "div") {

addressed in a885e77

Copilot

Copilot review overview

🟡 Changes recommended

Type-qualified and joint group configurations currently generate incorrect links and header markup.

Review effort: Balanced
Findings: 4 · 2

Open (6)

Use the shortname when constructing group join URLs · New
Parse the shortname from type-qualified group identifiers · New
Render separate copyright links for joint groups · New
Correct test fixture to use type/shortname group format · New
Include new statuses in the invalid-status recovery hint · New
Fix ungrammatical status information sentence · New

What changed in this PR

Adds redesigned CG-LIVING and CG-SNAPSHOT Community Group profiles with dedicated headers, metadata, assets, and supporting sections.

Changes:

Adds CG profile configuration, validation, templates, and pipeline modules.
Integrates external CG assets and metadata regions.
Adds comprehensive integration and unit coverage plus an example document.

File	Description
`tests/unit/w3c/cg-headers-spec.js`	Tests snapshot-index URL generation.
`tests/spec/w3c/cg-spec.js`	Covers profiles, metadata, assets, and variants.
`src/w3c/templates/cg-sotd.js`	Adds the redesigned minimal SotD.
`src/w3c/templates/cg-headers.js`	Builds redesigned CG headers.
`src/w3c/style.js`	Selects CG-specific assets.
`src/w3c/headers.js`	Registers statuses and templates.
`src/w3c/defaults.js`	Validates new configuration options.
`src/w3c/cg-spec.js`	Emits CG metadata identity.
`src/w3c/cg-sections.js`	Adds involvement and usage sections.
`src/w3c/cg-assets.js`	Loads and restores CG assets.
`src/type-helper.d.ts`	Types the new configuration.
`profiles/w3c.js`	Registers the new modules.
`examples/cg-living.html`	Demonstrates the living profile.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

deniak · 2026-10-07T12:08:53Z

+  // TODO:
+  // - `conf.group` is an array for joint publications
+  // - `conf.group` is an id
+  const group = typeof conf.group === "string" ? conf.group.split("/")[0] : "";


addressed in c5d3368

deniak · 2026-10-07T12:01:46Z

+    the Contributors to the ${titleNodes} Specification, published by the
+    <a href="${conf.wgURI}">${conf.wg}</a> under the ${agreement}


At this stage, my expectation is that CG specs will be produced by a single CG

deniak · 2026-10-07T11:51:28Z

+            The text of this specification and the status information support
+            for this specification are expected to change in place at this
+            address.


@ianbjacobs See this copilot suggestion on the text we expect at the top of the specs.

marcoscaceres

Some initial feedback...

marcoscaceres · 2026-10-14T03:22:56Z

+ * @param {"div" | "li"} elementName
+ */
+export function region(name, noScriptText, elementName = "div") {
+  const message = document.createElement("p");


Nit: this can probably just be a hyperHTML template. Easier to read.

marcoscaceres · 2026-10-14T03:31:38Z

+  const group =
+    typeof conf.group === "string" ? conf.group.split("/", 2).at(-1) : "";
+  if (!group || !conf.shortName) return "";
+  const base = `${INCUBATION}groups/${encodeURIComponent(group)}/specs/`;


Maybe safer/cleaner to use new URL(path , INCUBATION) here and have it return the .href?

marcoscaceres · 2026-10-14T03:32:13Z

+  if (conf.specStatus !== "CG-SNAPSHOT") return "";
+  if (!conf.shortName || !conf.publishDate) return "";
+  const dated = `${conf.shortName}-${concatDate(conf.publishDate)}`;
+  return `${INCUBATION}specs/${encodeURIComponent(dated)}/`;


As above... use new URL() for URL parsing.

marcoscaceres · 2026-10-14T03:35:52Z

+          </li>
+        </ul>
+      </div>`;
+    default:


default: should probably be a RespecError to catch unsupported/unexpected cases.

marcoscaceres · 2026-10-14T03:37:11Z

+ * @param {string} noScriptText
+ * @param {"div" | "li"} elementName
+ */
+export function region(name, noScriptText, elementName = "div") {


Nit: createRegion() maybe?

marcoscaceres · 2026-10-14T04:02:46Z

+ */
+function createScript(path) {
+  const src = cgAssetUrl(path);
+  const script = path.endsWith("cg-metadata.js")


As above... this seems somewhat fragile... something like createScript(path, options = {defer: false, async: false}) might be better

marcoscaceres · 2026-10-14T04:06:59Z

+  // is no one page to send a reader to for a joint publication.
+  const joinURL =
+    typeof conf.group === "string"
+      ? `${COMMUNITY}${conf.group.split("/", 2).at(-1)}/join`


As above... might be better to use new URL to construct these URLs.

marcoscaceres · 2026-10-14T04:08:28Z

+            "usage-guidance",
+            "The usage guidance for this specification is loaded from the status metadata, which needs JavaScript."
+          )}
+          ${DISCLAIMER}`


DISCLAIMER can probably just be inlined.

marcoscaceres · 2026-10-14T04:13:11Z

+  const message = document.createElement("p");
+  message.className = "cg-metadata-unavailable";
+  message.textContent = noScriptText;
+  const fallback = document.createElement("noscript");


I'm not sure any other feature uses noscript... given fixup.js will presumably be loaded, I wonder things will break regardless if JS is disabled?

marcoscaceres · 2026-10-14T04:16:14Z

  }
 }

+const CG_MATURITIES = ["draft", "transferred", "unmaintained"];


I'm a bit confused about "transferred"... if the document has been transferred, won't it just be a WD or ED? or is the expectation that transferred things would still be maintained? My experience has been that once transferred, they just transition to an appropriate W3C status.

sidvishnoi

I'll do some more passes after trying it locally..

sidvishnoi · 2026-10-14T05:26:41Z

+function noticeBox(conf) {
+  switch (cgVariant(conf)) {
+    case "snapshot":
+      return html`<div class="box box--information">


Nit: the templates here can be moved into individual functions, so it's cleaner. e.g. noticeBoxSnapshot(conf), noticeBoxTransferred(conf)

deniak added 9 commits October 6, 2026 09:38

add the different regions used by cg-metadata.js to display the metad…

0574022

…ata + introduce new boilerplates depending on the type of CG specs

adding tests

c80c005

do not add any generated paragraphs to the SotD

fdd6b28

transferred CGs require the name/link of the new organization

29fc102

generate snapshot thisVersion URL + fix trailing slash in the snapsho…

d18e406

…t index URL

add/fix tests

4e0cbfb

missing whitespace between the title and the maturity tag

44c572a

fix race condition with dark.js

a938dcf

deniak force-pushed the feat/cg-redesign-identity-assets branch from 8585b0b to a938dcf Compare October 6, 2026 05:38

create fallback with DOM calls instead of string interpolation as '<n…

868c470

…oscript>' parses its content as raw text

deniak requested a review from marcoscaceres October 6, 2026 07:02

marcoscaceres requested review from sidvishnoi and a balanced review from Copilot October 6, 2026 09:36

Copilot started reviewing on behalf of marcoscaceres October 6, 2026 09:37

View session

marcoscaceres reviewed Oct 6, 2026

View reviewed changes

Copilot AI reviewed Oct 6, 2026

View reviewed changes

deniak added 6 commits October 7, 2026 15:25

rename parameter for clarity

a885e77

chevron SVG: make it inline + add a aria-hidden attribute

4a36ea9

fix join link

c40efe2

Add new profiles to the supported types for CG

7073549

fix group shortname parsing

c5d3368

fix test

f4b89be

marcoscaceres reviewed Oct 14, 2026

View reviewed changes

sidvishnoi reviewed Oct 14, 2026

View reviewed changes

	export function region(name, noScriptText, as = "div") {
	export function region(name, noScriptText, elementName = "div") {

		the Contributors to the ${titleNodes} Specification, published by the
		<a href="${conf.wgURI}">${conf.wg}</a> under the ${agreement}

Conversation

deniak commented Sep 29, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

marcoscaceres commented Oct 6, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Copilot review overview

🟡 Changes recommended

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

marcoscaceres left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

sidvishnoi left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

This branch has not been deployed

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

deniak commented Sep 29, 2026 •

edited

Loading