From 5011ea3591f7e409541e93d518c7d09ed13389fa Mon Sep 17 00:00:00 2001 From: mrbobbytables Date: Thu, 22 Oct 2026 15:55:33 -0500 Subject: [PATCH] docs: record the DNS cutover to endusers.cncf.io as complete endusers.cncf.io is the Netlify custom domain and DNS points at it as of 2026-10-22: the site answers on the domain and the generated robots.txt already advertises https://endusers.cncf.io/sitemap.xml, so no build or config change was needed (ADR 0001 step 3, ADR 0005). Update AGENTS.md, README.md and ROADMAP.md to name the live domain, tick the two roadmap items that gated on the cutover, note completion in ADR 0001's status, and release the hold on filing the inbound-link requests for ADR 0004. Fixes #1433 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Signed-off-by: mrbobbytables --- AGENTS.md | 12 +++++------ README.md | 14 ++++++------- ROADMAP.md | 22 ++++++++++----------- adr/0001-site-ownership-and-cutover-path.md | 9 +++++---- adr/inbound-link-requests-for-0004.md | 7 +++---- 5 files changed, 30 insertions(+), 34 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index af20fd98..c2b268c5 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,12 +1,10 @@ # Agent Entry Point: CNCF End User Community Repository -This repository hosts the source for the CNCF End User Community site, currently -deployed on Netlify at (endusers.cncf.io is a -pending DNS cutover; see -[ADR 0001](./adr/0001-site-ownership-and-cutover-path.md), -[ADR 0005](./adr/0005-host-the-site-on-netlify.md) and issue #1433). It serves -practitioners, architects, and organizations running cloud native technologies -in production. +This repository hosts the source for the CNCF End User Community site at +, deployed on Netlify (see +[ADR 0001](./adr/0001-site-ownership-and-cutover-path.md) and +[ADR 0005](./adr/0005-host-the-site-on-netlify.md)). It serves practitioners, +architects, and organizations running cloud native technologies in production. ## Navigation diff --git a/README.md b/README.md index 4cf0aa66..a45d3c87 100644 --- a/README.md +++ b/README.md @@ -61,22 +61,20 @@ npm run docusaurus start -- --host 0.0.0.0 --port 3000 --poll 10000 The site deploys on [Netlify](https://www.netlify.com/) from `netlify.toml`, which is the only place build settings live. Every push to `main` publishes to -[endusers.netlify.app](https://endusers.netlify.app/) and every pull request -gets a deploy preview. The build command, `npm run build:netlify`, runs every +[endusers.cncf.io](https://endusers.cncf.io/) and every pull request gets a +deploy preview. The build command, `npm run build:netlify`, runs every `validate:*` gate before `build:production`, so a data regression fails the deploy instead of publishing. The canonical URL is derived from Netlify's `URL` variable (or -`DEPLOY_PRIME_URL` for previews and branch deploys), so no repository change is -needed when the custom domain is added: `BASE_URL` stays `/`, and once -[endusers.cncf.io](https://endusers.cncf.io/) is added as the Netlify custom -domain and DNS points at Netlify, the site's canonical links follow. Set -`SITE_URL` explicitly only to override that for a local build. +`DEPLOY_PRIME_URL` for previews and branch deploys), so `BASE_URL` stays `/` and +the site's canonical links follow the custom domain without a repository change. +Set `SITE_URL` explicitly only to override that for a local build. See [ADR 0005](./adr/0005-host-the-site-on-netlify.md) for the hosting decision, and [ADR 0001](./adr/0001-site-ownership-and-cutover-path.md) and [issue #1433](https://github.com/cncf/endusers/issues/1433) for the ownership -and DNS cutover plan. +decision and the DNS cutover, completed 2026-10-22. ## Metrics data diff --git a/ROADMAP.md b/ROADMAP.md index 5890e581..5ff9d606 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -17,8 +17,8 @@ named a specific conference as the announcement window (issue #104); the dated countdown slipped twice (#966, #1271) and was replaced by readiness gates on the Phase 1 content pillars below. Conferences and End User TAB meetings that fall near readiness are amplification opportunities, not deadlines. The ownership -decision has landed (ADR 0001 is Accepted; issue #99 closed); the remaining -pre-launch dependency is the DNS cutover tracked in issue #1433. +decision has landed (ADR 0001 is Accepted; issue #99 closed) and the DNS cutover +to `endusers.cncf.io` completed on 2026-10-22 (issue #1433). ## Guiding principles @@ -90,10 +90,10 @@ shipped silently. Content completeness alone is not a launch plan. baseline (captured 2026-10-02 under the `W-6` label the earlier dated plan used); re-run it immediately before launch so the 90-day comparison starts from the numbers the announcement went out on. -- [ ] **DNS cutover dependency**: the Phase 2 ownership decision (issue #46, +- [x] **DNS cutover dependency**: the Phase 2 ownership decision (issue #46, ADR 0001) is resolved — the repository has been transferred to the `cncf` - GitHub org — so cutover to `endusers.cncf.io` itself (Phase 3) is what - remains gating this item. + GitHub org — and the cutover to `endusers.cncf.io` (Phase 3) completed on + 2026-10-22 (#1433). - [ ] **90-day check-in**: re-run `npm run collect:launch-metrics` 90 days after launch and compare each signal against its `data/launch-metrics.json` baseline to record whether the launch moved the needle. @@ -118,18 +118,18 @@ Goal: the project can outlive any single maintainer. Goal: endusers.cncf.io becomes the authoritative end-user destination. -- [ ] DNS cutover to endusers.cncf.io (depends on Phase 2 ownership decision; - tracked in #1433, blocked on the external DNS record — the remaining ADR - 0001 step-3 action is adding the custom domain to the Netlify site and - pointing DNS at it; see ADR 0005) +- [x] DNS cutover to endusers.cncf.io (#1433): `endusers.cncf.io` is the Netlify + custom domain and DNS points at it as of 2026-10-22; the canonical URL and + `robots.txt` sitemap line followed without a repository change (ADR 0001 + step 3, ADR 0005) - [ ] Cross-linking with contribute.cncf.io and cncf.io (clear audience boundaries) (#1407). Audience boundary decided: ADR 0004. Outbound signposts shipped (site footer, architecture submission flow, community resources). Inbound-link requests against contribute.cncf.io and cncf.io remain open: ready-to-file drafts are in `adr/inbound-link-requests-for-0004.md` (origin issue #1434, closed once - the drafts shipped), but filing is deliberately held until the DNS cutover - (#1433) completes so requests do not point at a non-resolving URL. + the drafts shipped); with the DNS cutover (#1433) complete they are ready + to file. - [x] Public feedback loop: content-issue templates and a visible changelog (#1408). Shipped: the `content-issue.yml` report form and a changelog generated at build time (`adr/0003-public-changelog-mechanism.md`), both diff --git a/adr/0001-site-ownership-and-cutover-path.md b/adr/0001-site-ownership-and-cutover-path.md index 1e329426..5fdcebc5 100644 --- a/adr/0001-site-ownership-and-cutover-path.md +++ b/adr/0001-site-ownership-and-cutover-path.md @@ -4,10 +4,11 @@ - **Status note**: Option A — the repository has been transferred to the `cncf` GitHub org, which is the fact GitHub's own repository metadata now confirms. This ADR is not aware of a separate, minuted CNCF TOC/TAB vote; if one exists, - link it here. The remaining DNS cutover to `endusers.cncf.io` is still open — - see "Consequences" below. Amended 2026-10-14: hosting moved from GitHub Pages - to Netlify ([ADR 0005](./0005-host-the-site-on-netlify.md)), which changes - what step 3 below involves; the restated step is authoritative. + link it here. The DNS cutover to `endusers.cncf.io` completed on 2026-10-22 + ([#1433](https://github.com/cncf/endusers/issues/1433)); the ADR's steps are + all executed. Amended 2026-10-14: hosting moved from GitHub Pages to Netlify + ([ADR 0005](./0005-host-the-site-on-netlify.md)), which changes what step 3 + below involves; the restated step is authoritative. - **Date**: 2026-08-08 - **Tracking issue**: [#46](https://github.com/cncf/endusers/issues/46) diff --git a/adr/inbound-link-requests-for-0004.md b/adr/inbound-link-requests-for-0004.md index 66561ad4..05dbffc0 100644 --- a/adr/inbound-link-requests-for-0004.md +++ b/adr/inbound-link-requests-for-0004.md @@ -9,10 +9,9 @@ needs a maintainer with access to those repositories; this repository's agents cannot file them. Target pages are suggestions, to be confirmed against each site's current structure before filing. -Do not file these requests until the DNS cutover to `endusers.cncf.io` has -completed ([#1433](https://github.com/cncf/endusers/issues/1433)): the domain -does not resolve yet — the site is served from `endusers.netlify.app` in the -interim — so a request filed today would ask for links to a non-resolving URL. +The DNS cutover to `endusers.cncf.io` completed on 2026-10-22 +([#1433](https://github.com/cncf/endusers/issues/1433)), so the requested URLs +resolve and these requests can be filed. Origin issue: [#1434](https://github.com/cncf/endusers/issues/1434) (closed once these drafts shipped). Live status is the Status column below: when a request is