Skip to content

Register playground release-notes repos in assembler.yml scrubber allowlist - #3980

Merged
Mpdreamz merged 2 commits into
mainfrom
feature/onboard-rn-test-repos
Aug 31, 2026
Merged

Register playground release-notes repos in assembler.yml scrubber allowlist#3980
Mpdreamz merged 2 commits into
mainfrom
feature/onboard-rn-test-repos

Conversation

@Mpdreamz

Copy link
Copy Markdown
Member

Adds docs-playground-release-notes-changelogs and docs-playground-release-notes-tagged to config/assembler.yml so PR and issue links in their bundled release notes survive the changelog scrubber. Both repos stay private: true (making them public requires IT approval).

Affects: Release notes

Why

The changelog scrubber Lambda uses assembler.yml as its allowlist of repos whose links are permitted in the public CDN bucket. Without these entries, any PR link in a published bundle would be rewritten to a PRIVATE: sentinel. The repos are private, so only link metadata is scrubbed — no doc content is assembled from them.

Risk: config/assembler.yml is baked into the changelog-scrubber Lambda as its allowlist at build time. The deployed Lambda picks up the new allowlist on the next Lambda release after this merges.

Stack: 2 of 2, follow-on to #3978.

…owlist

Both repos stay private (IT approval needed to make them public), so they get
`private: true`. The scrubber allowlist controls which repo links survive
sanitisation in the public CDN bucket — without these entries, PR links in
bundled release notes would be rewritten to PRIVATE: sentinels.

Co-Authored-By: Claude <noreply@anthropic.com>
@Mpdreamz
Mpdreamz requested a review from a team as a code owner August 31, 2026 14:24
@Mpdreamz
Mpdreamz requested a review from theletterf August 31, 2026 14:24
@github-actions

Copy link
Copy Markdown

Docs preview (local build)

Handbook preview: https://docs-v3-preview.elastic.dev/elastic/docs-builder/pull/3980/

`AssemblyConfiguration.PrivateRepositories` is populated before
`--skip-private-repositories` removes private entries, and
`AssemblerCrossLinkFetcher` concatenates those repos back in to fetch
their cross-links. Without `skip: true`, both entries failed the
assembler `build` and `validate-assembler` CI checks with:

  Repository docs-playground-release-notes-changelogs not found in link index

The established shape for a repo listed for changelog link-visibility
only (no docs site) is `private: true` + `skip: true` — matching the
ten existing team repos (`kibana-team`, `search-team`, etc.) and
documented in `LinkAllowlistSanitizer.BuildAllowReposFromAssembler`.

While both repos are private the allowlist entries are a behavioural
no-op: `BuildAllowReposFromAssembler` skips anything `Private`, so
published output is unchanged. The SHA baked into the
changelog-scrubber Lambda will mismatch until the next release redeploys
it; that is expected and not a regression.

Co-Authored-By: Claude <noreply@anthropic.com>
@Mpdreamz
Mpdreamz merged commit bc370c6 into main Aug 31, 2026
32 checks passed
@Mpdreamz
Mpdreamz deleted the feature/onboard-rn-test-repos branch August 31, 2026 15:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant