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
81 changes: 40 additions & 41 deletions adr/0001-site-ownership-and-cutover-path.md
Original file line number Diff line number Diff line change
@@ -1,28 +1,35 @@
# ADR 0001: Site ownership and cutover path for endusers.cncf.io

- **Status**: Proposed
- **Status**: Accepted
- **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.
- **Date**: 2026-08-08
- **Decision deadline**: 2026-08-17 (LAUNCH.md week W-12; see "Decision" below)
- **Tracking issue**: [#46](https://github.com/castrojo/endusers/issues/46)
- **Tracking issue**: [#46](https://github.com/cncf/endusers/issues/46)

## Context

The README describes this site as "the home of the CNCF End User Community" and
the build deploys content branded `endusers.cncf.io`. In practice today:
the build deploys content branded `endusers.cncf.io`. At the time this ADR was
originally written:

- The source repository lives in a personal account (`castrojo/endusers`), not a
- The source repository lived in a personal account (`castrojo/endusers`), not a
CNCF-owned GitHub org.
- The repository's GitHub Pages homepage is `castrojo.github.io/endusers`, not
- The repository's GitHub Pages homepage was `castrojo.github.io/endusers`, not
the `endusers.cncf.io` domain.
- Content is derived from authoritative CNCF sources (cncf/architecture,
cncf/landscape, cncf/tab), so alignment with CNCF is already a stated
requirement (see `AGENTS.md`), but there is no CNCF org ownership, no DNS
cutover, and no documented governance decision.
requirement (see `AGENTS.md`).

Until this is resolved, every investment in content, SEO, and metrics
accumulates in a property whose long-term home is undecided. This is a
strategic risk for adoption and for contributor recruitment, and it blocks
Phase 2/3 of the roadmap (see `ROADMAP.md`, PR #50).
Since then, the repository has been transferred: it now lives at
[cncf/endusers](https://github.com/cncf/endusers), with GitHub Pages served at
`cncf.github.io/endusers`. The `endusers.cncf.io` domain itself is still not
wired up (no DNS record, no `static/CNAME`), so every investment in content,
SEO, and metrics still accumulates under a staging URL rather than the
intended production domain. This remaining DNS cutover is what blocks
Phase 3 of the roadmap (see `ROADMAP.md`).

## Decision drivers

Expand Down Expand Up @@ -74,43 +81,35 @@ contributor-site or cncf.io) instead of standing up a new one.

## Decision

Not yet made. This ADR exists to record the options and their tradeoffs so
that CNCF end-user/TAB stakeholders and the repo owner can make an informed
decision. The decision itself belongs to the owner and CNCF stakeholders, not
to automated tooling.

To keep this from stalling silently (see issue #99), a decision deadline is
recorded above: **2026-08-17**. This date is not a default answer — it is the
point by which the owner and CNCF stakeholders should have picked among
Options A, B, and C (or explicitly extended the deadline in a follow-up PR to
this ADR). `LAUNCH.md` treats this ADR's decision as its W-12 gating
milestone, since the announcement plan cannot name the site's permanent home
until this is resolved.

If the deadline passes without a decision, the fallback is Option B (stay
personal) by default, purely to avoid blocking Phase 1/2 content work — this
default does not close the ADR or set Status to Accepted, it just documents
what "no decision yet" means operationally for downstream work.
**Option A (transfer to the `cncf` GitHub org) has been executed.** The
repository now lives at [cncf/endusers](https://github.com/cncf/endusers)
instead of `castrojo/endusers`, which resolves the ownership question this
ADR was tracking. This section records that fact as it is verifiable from
GitHub's repository metadata; it does not assert that a specific CNCF
TOC/TAB meeting or vote produced this outcome. If such a record exists,
please link it here in a follow-up PR.

## Proposed next step

1. Open a discussion with CNCF end-user community and TAB stakeholders on the
intended long-term home for this content (see options above). A
ready-to-send outreach draft, with suggested venues and stakeholders, is
available at [stakeholder-outreach-draft-for-0001.md](./stakeholder-outreach-draft-for-0001.md)
(proposed in PR #113).
1. ~~Open a discussion with CNCF end-user community and TAB stakeholders on
the intended long-term home for this content~~ — superseded by the
transfer. The outreach draft at
[stakeholder-outreach-draft-for-0001.md](./stakeholder-outreach-draft-for-0001.md)
is retained for historical context on the options considered.
2. Land the prerequisites shared by every option regardless of outcome:
LICENSE (done: #32 / PR #40) and a governance/MAINTAINERS note (#47).
3. By the decision deadline above, update this ADR's Status and Decision
sections, link the outcome from `ROADMAP.md` Phase 2, and open the
follow-up issues/PRs needed to execute it (org transfer, DNS cutover, or
content merge).
3. Execute the DNS cutover to `endusers.cncf.io` (add `static/CNAME`, verify
the custom domain in GitHub Pages settings, and switch the deploy
workflow's `SITE_URL`/`BASE_URL`), then update `ROADMAP.md` Phase 3
accordingly.

## Consequences

- Until a decision is recorded here, roadmap items that depend on ownership
(DNS cutover, cross-linking with contribute.cncf.io/cncf.io) remain blocked
by design.
- The ownership question is resolved: `cncf/endusers` is the canonical,
CNCF-owned repository.
- The remaining roadmap item that depends on ownership — DNS cutover to
`endusers.cncf.io` and cross-linking with contribute.cncf.io/cncf.io —
stays open until that cutover is executed.
- This ADR should be superseded (not silently edited into a different
decision) if the chosen path changes after being recorded, so the history of
the decision stays auditable.
2 changes: 1 addition & 1 deletion adr/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ still pending) so future contributors understand why, not just what.

| ADR | Title | Status |
| ------------------------------------------------- | ---------------------------------------------------- | -------- |
| [0001](./0001-site-ownership-and-cutover-path.md) | Site ownership and cutover path for endusers.cncf.io | Proposed |
| [0001](./0001-site-ownership-and-cutover-path.md) | Site ownership and cutover path for endusers.cncf.io | Accepted |
| [0002](./0002-peoplehub-fleet-status.md) | peoplehub fleet status — pause agent work | Accepted |

Supporting material is not part of the numbered ADR sequence and is not
Expand Down
6 changes: 6 additions & 0 deletions adr/stakeholder-outreach-draft-for-0001.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,11 @@
# Stakeholder outreach draft for ADR 0001

> **Historical note:** the repository has since been transferred to the
> `cncf` GitHub org, resolving the ownership question this draft was written
> to help discuss (see [ADR 0001](./0001-site-ownership-and-cutover-path.md),
> "Decision"). This draft is kept for historical context on the options that
> were considered; it does not need to be sent.

This is a ready-to-send draft supporting [ADR 0001](./0001-site-ownership-and-cutover-path.md)
"Proposed next step" #1: opening a discussion with CNCF end-user/TAB
stakeholders on the long-term home for this site. It exists so a maintainer
Expand Down
2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
Expand Up @@ -60,7 +60,7 @@
},
"repository": {
"type": "git",
"url": "git+https://github.com/castrojo/endusers.git"
"url": "git+https://github.com/cncf/endusers.git"
},
"author": "CNCF",
"license": "CC-BY-4.0",
Expand Down
Loading