Skip to content

docs: repoint stale Codeberg URLs to GitHub - #163

Merged
rubenvdlinde merged 1 commit into
developmentfrom
fix/repoint-codeberg-links-to-github
Aug 24, 2026
Merged

docs: repoint stale Codeberg URLs to GitHub#163
rubenvdlinde merged 1 commit into
developmentfrom
fix/repoint-codeberg-links-to-github

Conversation

@rubenvdlinde

Copy link
Copy Markdown
Contributor

Why

GitHub is the only host for this organisation. Codeberg was a mirror and was retired on 2026-08-04, so every codeberg.org link in this repo is dead. This repo is also a template other apps are generated from, so a stale link here propagates into every new app.

What changed (13 files)

Category Count Notes
Repo/org URLs 9 codeberg.org/Conduction/<slug>github.com/ConductionNL/<slug>
/src/branch/<B>/<FILE>/blob/<B>/<FILE> 3 ADR links, LICENSE
/src/branch/<B>/<DIR>/tree/<B>/<DIR> 2 hydra/scripts/fleet-sync (a directory)
/raw/branch/<B>/…/raw/<B>/… 3 $schema URLs for the app manifest
Badges 2 Gitea release badge → shields GitHub release badge; ci.codeberg.org status badge → GitHub Actions badge
clone commands 3 README, docs/intro.md, design.md
Docusaurus 2 navbar label CodebergGitHub; editUrl/edit/development/docs/
Issue/PR link de-linked 1 see below

Two judgement calls

1. Issue/PR numbers are not mapped across hosts. The openregister PR #1466 reference in README.md lost its URL and kept the fact as plain text. GitHub serves /pulls/<N> as the PR list page with HTTP 200, so a naive host swap would point at the wrong page while passing any status-code check.

2. adr-033-root-config-consolidation.md was dead on both hosts. hydra renumbered it: the file is now adr-039-root-config-consolidation.md (identical slug, title ADR-039: Root Configuration Consolidation, verified via the GitHub API). The link points at ADR-039 rather than swapping one dead URL for another dead URL.

Deliberately left as-is

  • .forgejo/workflows/*runs-on: codeberg-medium is a CI runner label, not a link. Also codeberg-small in a comment. Untouched.
  • .github/workflows/l10n-parity.yml — a historical comment recording that Codeberg was retired on 2026-08-04. That is a fact about the past, not a stale link.

Also noted while surveying: Discussions is disabled on this repo, so a /discussions URL 404s legitimately — no such URL was introduced.

Verification

  • grep -ril codeberg . (plain grep, not git grep) — every remaining hit is one of the deliberate keeps listed above.
  • Changed JSON re-parsed (app-config.json, hydra.json, src/manifest.json), node --check on docusaurus.config.js and src/registry.js, yaml.safe_load on publiccode.yml — all clean.
  • Every introduced URL diffed individually (no GitHub-host-with-Codeberg-path-shape hybrids) and spot-checked with curl -LHTTP 200 for all 8 public targets. Private hydra targets confirmed with gh api (anonymous curl 404s on a private repo).
  • Confirmed tests/validate-manifest.js selects the schema variant via $schema.includes('app-manifest-v2') — host-agnostic, so the $schema host change cannot break manifest validation.
  • No PHP files changed.

GitHub is the only host for this org; Codeberg was a mirror and was retired
on 2026-08-04, so every codeberg.org link in this repo is dead.

Conversions applied (13 files):
- Repo/org: codeberg.org/Conduction/<slug> -> github.com/ConductionNL/<slug>
  (openregister, hydra, nextcloud-vue, nextcloud-app-template).
- Path shapes: /src/branch/<B>/<FILE> -> /blob/<B>/<FILE>, /src/branch/<B>/<DIR>
  -> /tree/<B>/<DIR>, /raw/branch/<B>/<p> -> /raw/<B>/<p>.
- Badges: the Gitea release badge became the shields GitHub release badge and
  the ci.codeberg.org status badge became the GitHub Actions badge for
  .github/workflows/code-quality.yml (confirmed the workflow file exists).
- Docusaurus navbar label 'Codeberg' -> 'GitHub'; editUrl -> /edit/development/docs/.

Two judgement calls, recorded deliberately:
- Issue/PR numbers are NOT mapped across hosts. The openregister PR #1466 link
  in README.md lost its URL and kept the fact as plain text; GitHub serves
  /pulls/<N> as the PR list page with HTTP 200, so a host swap would have
  pointed at the wrong page while passing any status check.
- docs/canonical-files.md pointed at adr-033-root-config-consolidation.md, which
  exists on neither host: hydra renumbered it to adr-039 (identical slug, title
  "ADR-039: Root Configuration Consolidation", verified via the GitHub API).
  The link now points at adr-039 rather than swapping one dead URL for another.

Left untouched on purpose:
- .forgejo/workflows/* `runs-on: codeberg-medium` — CI runner labels, not links.
- .github/workflows/l10n-parity.yml — historical note that Codeberg was retired.

All introduced URLs were spot-checked (HTTP 200); private hydra targets were
confirmed via `gh api`. Changed JSON/JS/YAML re-parsed clean.
@github-actions

Copy link
Copy Markdown
Contributor

Quality Report — ConductionNL/nextcloud-app-template @ 144797e

Check PHP Vue Security License Tests
lint
phpcs
phpmd
psalm
phpstan
phpmetrics
eslint
stylelint
build
check-specs
check-manifest
format
composer ✅ 103/103
npm ✅ 720/720
app:check-code ⏭️
info.xml
REUSE
PHPUnit
Newman
Playwright
Hydra gates

Quality workflow — 2026-08-24 10:53 UTC

Download the full PDF report from the workflow artifacts.

@rubenvdlinde
rubenvdlinde merged commit daa841b into development Aug 24, 2026
81 checks passed
@rubenvdlinde
rubenvdlinde deleted the fix/repoint-codeberg-links-to-github branch August 24, 2026 15:59
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.

1 participant