Skip to content

Accept prestage/on-release path values in products.yml features.release-notes - #3854

Open
cotti wants to merge 4 commits into
mainfrom
feature/products-release-notes-path
Open

Accept prestage/on-release path values in products.yml features.release-notes#3854
cotti wants to merge 4 commits into
mainfrom
feature/products-release-notes-path

Conversation

@cotti

@cotti cotti commented Aug 13, 2026

Copy link
Copy Markdown
Contributor

Why

The release-notes onboarding RFC (docs-eng-team#698, item B3) registers each product's onboarding path in products.yml so central automation — the Prestage Release Orchestrator, onboarding validation (next PR in this stack) — can resolve which repositories participate and how. Today features.release-notes only parses as a boolean.

What

features.release-notes now accepts prestage and on-release alongside the historical booleans, resolving to a ReleaseNotesPath (None/OnRelease/Prestage) on the product model. Backward compatible: omitted/true mean on-release participation (the previous default), false opts out, so every existing products.yml parses unchanged. The features map is now string-valued with explicit per-key validation, and invalid values get actionable errors. Catalog docs updated with the value table.

Stack: 1/5 of the RFC B-items (B3 → B4 → B2 → B1 → B5), based on #3849.

GitHubPrService, GitHubReleaseService, and GitHubCommitRangeService each
duplicated HttpClient setup, User-Agent/Accept headers, and GITHUB_TOKEN
bearer attachment; the two older services used a static client that could
not be faked at the HTTP level. The shared transport centralizes those
concerns and gives every consumer an injectable HttpMessageHandler for
fake-HTTP tests, while each service keeps its own response policy
(lenient warn-and-null vs strict fail-the-run).

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
An error occurred while trying to automatically change base from feature/github-api-transport to main August 13, 2026 12:04
@cotti
cotti force-pushed the feature/products-release-notes-path branch from f9d00bd to befd3a6 Compare August 13, 2026 12:48
…se-notes

The release-notes onboarding RFC (docs-eng-team#698, B3) registers each
product's onboarding path in products.yml. The features map now accepts
strings so release-notes can declare prestage or on-release; the
historical booleans keep their meaning (omitted/true = on-release
participation, false = opted out), so existing files parse unchanged.
The Prestage Release Orchestrator and onboarding validation build on
this flag.

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
@cotti
cotti force-pushed the feature/products-release-notes-path branch from befd3a6 to 33bc407 Compare August 13, 2026 12:48
@cotti
cotti deleted the branch main August 13, 2026 12:49
@cotti cotti closed this Aug 13, 2026
@cotti cotti reopened this Aug 13, 2026
@cotti
cotti changed the base branch from feature/github-api-transport to main August 13, 2026 12:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants