Skip to content

ci: add reusable docs CI orchestrator for aggregated repositories - #215

Merged
yeoldegrove merged 1 commit into
mainfrom
feat/reusable_aggregated_docs_workflow
Oct 28, 2026
Merged

yeoldegrove merged 1 commit into
mainfrom
feat/reusable_aggregated_docs_workflow

Conversation

@yeoldegrove

@yeoldegrove yeoldegrove commented Oct 27, 2026 •

Copy link
Copy Markdown
Contributor

What this PR does / why we need it:

Centralize the documentation CI so aggregated repositories only need a thin caller workflow. The new reusable workflow aggregated-repo-docs.yml runs detect-changes, docs-checks, the gate, and the notify dispatch, and notifies docs only when a PR actually touched documentation-relevant paths (no docs preview PR for unrelated merges).

Documentation-relevant paths are derived from repos-config.json (docs_path + root_files) with an optional docs_paths override, so the path definitions live in a single place instead of in every repository.

  • add .github/workflows/aggregated-repo-docs.yml (paths-filter based)
  • add RepoConfig.docs_paths and resolved_docs_paths, persist on save
  • add unit tests for docs_paths round-trip and derivation

Which issue(s) this PR fixes:

Fixes #214

@netlify

netlify Bot commented Oct 27, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for gardenlinux-docs ready!

Name Link
🔨 Latest commit dc02ec5
🔍 Latest deploy log https://app.netlify.com/projects/gardenlinux-docs/deploys/6ae0b60ee93a8ae86093d0b0
😎 Deploy Preview https://deploy-preview-215--gardenlinux-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

Centralize the documentation CI so aggregated repositories only need a
thin caller workflow. The new reusable workflow aggregated-repo-docs.yml
runs detect-changes, docs-checks, the gate, and the notify dispatch, and
notifies docs only when a PR actually touched documentation-relevant
paths (no docs preview PR for unrelated merges).

Documentation-relevant paths are derived from repos-config.json
(docs_path + root_files) with an optional docs_paths override, so the
path definitions live in a single place instead of in every repository.

- add .github/workflows/aggregated-repo-docs.yml (paths-filter based)
- add RepoConfig.docs_paths and resolved_docs_paths, persist on save
- add unit tests for docs_paths round-trip and derivation

Signed-off-by: Eike Waldt <waldt@b1-systems.de>
On-behalf-of: SAP <eike.waldt@sap.com>
Assisted-by: Kilo:claude-sonnet-4-6
@yeoldegrove
yeoldegrove force-pushed the feat/reusable_aggregated_docs_workflow branch from 04916bb to dc02ec5 Compare October 27, 2026 14:32
@yeoldegrove
yeoldegrove requested a review from ByteOtter October 27, 2026 14:33
@yeoldegrove yeoldegrove self-assigned this Oct 27, 2026
@yeoldegrove
yeoldegrove merged commit 317f2e5 into main Oct 28, 2026
14 of 15 checks passed
@yeoldegrove
yeoldegrove deleted the feat/reusable_aggregated_docs_workflow branch October 28, 2026 10:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[BUG] "Documentation Preview PRs" are created on non-docs related PRs

2 participants