Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 5 additions & 7 deletions AGENTS.md
Original file line number Diff line number Diff line change
@@ -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 <https://endusers.netlify.app/> (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
<https://endusers.cncf.io/>, 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

Expand Down
14 changes: 6 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
22 changes: 11 additions & 11 deletions ROADMAP.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down Expand Up @@ -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.
Expand All @@ -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
Expand Down
9 changes: 5 additions & 4 deletions adr/0001-site-ownership-and-cutover-path.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)

Expand Down
7 changes: 3 additions & 4 deletions adr/inbound-link-requests-for-0004.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
Loading