Skip to content

chore: fix docs sync — GitHub Actions link + drop repo-maintenance pointer#203

Merged
mmanciop merged 1 commit into
mainfrom
docs/sync-github-actions-fixes
Jul 17, 2026
Merged

chore: fix docs sync — GitHub Actions link + drop repo-maintenance pointer#203
mmanciop merged 1 commit into
mainfrom
docs/sync-github-actions-fixes

Conversation

@mmanciop

@mmanciop mmanciop commented Jul 17, 2026

Copy link
Copy Markdown
Member

Two corrections to the docs synced into dash0hq/dash0-website, after the recent move of docs/github-actions.md under a nested github-actions/ group on the website:

  • Fix broken links (CI check-links failure). docs/about.md, docs/installation.md, and docs/quickstart.md all link to github-actions.md. Since the sync now maps docs/github-actions.mdgithub-actions/about.md, that relative link resolves to /docs/.../github-actions on the website (no page) rather than /docs/.../github-actions/about. Added per-file replace-regex transformations that rewrite the link during sync. This resolves the check-links failure on dash0-website PR #607.
  • Drop the repo-maintenance pointer. The last paragraph of docs/github-actions.md pointed at docs/github-actions-maintenance.md, which is contributor-facing content. Cursor Bugbot flagged it as internal implementation detail leaking into customer docs. Deleting the paragraph from the source (rather than stripping it via a sync transformation) keeps the repo view and the website view identical, and avoids a fragile regex that would break on any future wording change. Contributors browsing docs/ will still find github-actions-maintenance.md on their own — it sits right next to github-actions.md.

…inter

Two corrections after `docs/github-actions.md` was moved under a
nested `github-actions/` group on the website:

- Rewrite the `github-actions.md` link in about.md, installation.md,
  and quickstart.md to `github-actions/about.md` during sync. Without
  this, the synced pages ship broken relative links that the website
  link-checker rejects.
- Delete the "For repository-side maintenance notes..." paragraph
  from `docs/github-actions.md`. That pointer targeted contributors
  reading the repo; contributors will find
  `docs/github-actions-maintenance.md` on their own since it sits
  next to `docs/github-actions.md` in the same directory. Removing
  it from the source keeps the repo view and the website view
  identical and avoids a fragile sync-time regex.
@mmanciop
mmanciop merged commit e2ed5a9 into main Jul 17, 2026
68 checks passed
@mmanciop
mmanciop deleted the docs/sync-github-actions-fixes branch July 17, 2026 16:52
@github-actions github-actions Bot locked and limited conversation to collaborators Jul 17, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant