Skip to content

Release version 2026.08.28 of the Baseline - #542

Merged
eddie-knight merged 9 commits into
ossf:mainfrom
eddie-knight:ci/release
Aug 28, 2026
Merged

Release version 2026.08.28 of the Baseline#542
eddie-knight merged 9 commits into
ossf:mainfrom
eddie-knight:ci/release

Conversation

@eddie-knight

@eddie-knight eddie-knight commented Aug 27, 2026

Copy link
Copy Markdown
Contributor

Release version 2026.08.28 of the Baseline

Closes #543

This PR cuts the v2026.08.28 release and ships the website tooling it depends on.

See the published section in docs/release_notes.md.

Website & tooling changes

  • Control mappings are now compiled from machine-readable Gemara mapping documents and published to grc.store with each release. The External Frameworks table links each framework's mapping document, and each version gets a generated External Framework Crosswalk page (external requirement → OSPS controls).
  • The release pages are compiled with --artifact-version v2026.08.28, pinning every grc.store mapping link to this release's tag.
  • make dev compiles the pages and serves the site locally for review.
  • Lexicon fixes: duplicate SAMM/PSSCRM glossary entry retitled, stale SLSA entry and dead #ci-cd-pipeline anchors dropped, validator now rejects lexicon terms that shadow mapping-reference ids.
  • The release process is now documented in CONTRIBUTING.md ("Cutting a Release").

Reviewing

Run make dev and browse http://127.0.0.1:4000 for a final check before approving.

Known dead links, expected: the pinned mapping-document links on the new version page (…/versions/v2026.08.28) will 404 until the post-merge GitHub Release runs publish.yaml. This is not a bug in the PR.

Each compiled version page's External Frameworks table now links the
framework's Gemara mapping document on grc.store, and the reverse
crosswalk generator (previously unused by the site) renders one section
per framework and is wired into the Pages build as devel-crosswalk.md.
A new --artifact-version compile flag pins the grc.store links to a
published release tag; unset, they point at the latest version.

Signed-off-by: Eddie Knight <knight@linux.com>
Compiled RC page set (controls, checklist, and the new external
framework crosswalk), linked from the versions list. Release notes for
2026-08-26 are drafted but stay commented out until the release, which
will also promote the page to Current Version per the usual process.

Signed-off-by: Eddie Knight <knight@linux.com>
Compiles the devel pages the same way web-publish.yml does (including
the new crosswalk) and serves the site with Jekyll at 127.0.0.1:4000.
devel-crosswalk.md joins the other generated devel pages in .gitignore.

Signed-off-by: Eddie Knight <knight@linux.com>
…base

An empty artifact id now yields an empty URL from artifactURL rather
than a link to the bare grc.store namespace, with a test covering the
pinned, unpinned, and empty cases.

The 2026-08-26 RC page is regenerated against main after ossf#540, which
removed the unmapped framework metadata rows and the framework lexicon
entries (including the duplicate PSSCRM term) and linked each
per-control framework relation to its row in the External Frameworks
table — where the new Mapping Document column links to grc.store.

Signed-off-by: Eddie Knight <knight@linux.com>
SLSA was the one framework ossf#540 left in the lexicon, so it still
rendered as a glossary entry alongside its External Frameworks row. The
validator now rejects any lexicon term or synonym that shadows a
mapping-reference id, so a framework can't reappear in the glossary.

asLink mapped every non-letter to '-', but kramdown deletes '/' when
deriving a heading id, so each [CI/CD Pipeline] link pointed at the
dead anchor #ci-cd-pipeline instead of #cicd-pipeline. Drop '/' the
way '.' already is, with a test pinning the anchor scheme.

RC page regenerated; historical release pages are left as released.

Signed-off-by: Eddie Knight <knight@linux.com>
Converts the release-candidate pages to the final release: pages
recompiled with grc.store mapping links pinned to v2026.08.28, nav and
index updated to make v2026.08.28 the current version, and the drafted
release notes published.
@funnelfiasco

Copy link
Copy Markdown
Contributor

I don't see a corresponding issue, which would give you the full checklist to follow. Not a requirement, but a Good Idea™

@funnelfiasco

Copy link
Copy Markdown
Contributor

I don't see a corresponding issue, which would give you the full checklist to follow. Not a requirement, but a Good Idea™

I do see that you added some instructions to CONTRIBUTING.md. If that's supposed to obviate the issue template, we should remove that to avoid confusion.

@eddie-knight

Copy link
Copy Markdown
Contributor Author

Ah, thanks for flagging @funnelfiasco, I forgot we had the issue template

@eddie-knight eddie-knight mentioned this pull request Aug 27, 2026
16 tasks
@eddie-knight
eddie-knight merged commit a26a796 into ossf:main Aug 28, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Release]: 2026.08.28

3 participants