Skip to content

docs: repoint stale Codeberg URLs to GitHub - #725

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

docs: repoint stale Codeberg URLs to GitHub#725
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 org. Codeberg was a mirror and is not used, including for issues.

Many of these links also carried a pre-rename repo name. This repo is now ConductionNL/stackiq (was softwarecatalog); nldesignthematiq, OpenConnectorintegriq, decideskdecidiq.

What changed — 24 files, 42 lines

Category Count Conversion
PHP @link docblock → this repo 21 codeberg.org/Conduction/SoftwareCataloggithub.com/ConductionNL/stackiq (13 files)
PHP @link docblock → integriq 4 codeberg.org/Conduction/OpenConnectorgithub.com/ConductionNL/integriq
README dependency links 8 openregister, opencatalogi, nldesign→thematiq, tilburg-woo-ui, launchpad
Bare org URL 1 docs/static/llms.txtgithub.com/ConductionNL (its label already read "GitHub")
Live CI clone URL 1 .forgejo/workflows/tests-live.yml
Hydra record repo field 4 github.com/ConductionNL/stackiq (issue-less records only)
Issue/PR URLs removed, fact kept as text 2 see below

.forgejo/workflows/tests-live.yml was doing a real git clone --depth 1 https://codeberg.org/Conduction/openregister.git — that job clones from a dead host. Only the URL changed; the workflow and the .forgejo/ directory are untouched.

Issue / PR numbers were deliberately NOT mapped

Codeberg numbers do not correspond to GitHub ones — rewriting only the host would point at a real but unrelated GitHub PR. Both references to the decidesk reference-PR are now plain text: "Codeberg decidesk#160 (pre-migration, not migrated to GitHub; decidesk is now decidiq)".

🔴 Deliberate keeps

32 runtime configuration URLs in lib/Settings/softwarecatalogus_register.json — LEFT, and they need a real fix.

They point at codeberg.org/Conduction/opencatalogi/raw/branch/master/apps-extra/opencatalogi/lib/Settings/publication_register_magic.json. I checked the full recursive tree of ConductionNL/opencatalogi on both master and main: publication_register_magic.json does not exist there at all (only lib/Settings/publication_register.json), and the apps-extra/opencatalogi/ prefix is a local workspace path, not a repo path.

So these URLs are dead for two independent reasons. Repointing only the host would produce 32 URLs that still 404 while looking fixed — a false green on register seed data that is fetched at runtime. Substituting publication_register.json would be a different config file and a behaviour change. This needs someone who knows what that file was meant to be.

4 hydra records left intact — their codeberg repo sits next to an issue number or issue URL, so repointing the repo alone would make the record assert an unrelated GitHub issue: deelnames-gebruik (6), softwarecatalog-manifest-v1 (14), softwarecatalog-notifications (15), method-decomposition (issue URL 274).

🔴 An openspec requirement MANDATES the word "Codeberg"openspec/changes/beta-surface-alignment/specs/beta-alignment/spec.md:28:

THEN it MUST read "EUPL-1.2" and "Codeberg", not "AGPL" / "GitHub"

with docs/GOVERNMENT-FEATURES.md:61 (| T-02 | Open source | Beschikbaar | EUPL-1.2, Codeberg |) as the governed line, plus the matching proposal.md / tasks.md entries. That change deliberately moved the attribution from GitHub to Codeberg. Reversing it is a decision, not a link fix — left for a human.

.forgejo/ — kept, not deleted. Runner labels (codeberg-medium / -small) are not links. ⚠️ Note .forgejo/workflows/release-beta.yml:14 references a CODEBERG_TOKEN secret (CODEBERG_TOKEN: ${{ secrets.CODEBERG_TOKEN }}) — flagged as requested, not touched.

Historical prosesrc/manifest.json:196 (codeberg softwarecatalog#76, already plain text), adopt-apphost/tasks.md, softwarecatalog-legacy-quality-cleanup/tasks.md.

Verification

  • git grep -In "codeberg\.org" — every remaining hit is a deliberate keep listed above.
  • php -l on all 15 changed PHP files — clean.
  • vendor/bin/phpcs --standard=phpcs.xml on the changed PHP files: 0 errors, 20 warnings. Baseline measured on the same files before the change: 0 errors, 20 warningsno new issues. (The warnings are pre-existing missing-@spec-tag warnings, unrelated to a @link URL.)
  • All 4 changed JSON files re-parsed with json.load — OK. tests-live.yml re-parsed with yaml.safe_load — OK.
  • 8 converted URLs spot-checked with curl -Lall 200, including the renamed thematiq, integriq, stackiq and tilburg-woo-ui (which was not in the rename map — confirmed to exist via gh api).

GitHub is the only host for this org — Codeberg was a mirror and is no
longer used, including for issues. Many of these links also carried a
PRE-RENAME repo name: this repo is now ConductionNL/stackiq (was
softwarecatalog), nldesign is thematiq, OpenConnector is integriq, and
decidesk is decidiq.

Converted (24 files):
- 21 PHP @link docblock tags -> github.com/ConductionNL/stackiq (13 files)
- 4 PHP @link tags naming OpenConnector -> github.com/ConductionNL/integriq
- 8 README dependency links (openregister, opencatalogi, nldesign->thematiq,
  tilburg-woo-ui, launchpad)
- docs/static/llms.txt org link -> github.com/ConductionNL (its label already
  said "GitHub")
- .forgejo/workflows/tests-live.yml: the live `git clone` of openregister was
  still pointing at codeberg.org — CI would clone from a dead host.
- 4 hydra change records ("repo" field, issue-less only)

Issue / PR numbers deliberately NOT mapped. Codeberg numbers do not correspond
to GitHub ones, so rewriting only the host would point at a real but unrelated
GitHub item. The two decidesk PR-160 links are replaced with plain text.

Deliberately left alone (see PR body):
- 32 "configuration" URLs in lib/Settings/softwarecatalogus_register.json.
  These are RUNTIME-fetched register config pointing at
  opencatalogi/.../publication_register_magic.json — a file that does not
  exist in ConductionNL/opencatalogi on ANY branch. Repointing the host would
  swap a dead Codeberg URL for a dead GitHub one and merely look fixed.
- 4 hydra records whose codeberg "repo" sits next to an issue number/URL.
- The beta-surface-alignment openspec requirement that MANDATES the word
  "Codeberg" in docs/GOVERNMENT-FEATURES.md, and that doc line.
- .forgejo runner labels and the CODEBERG_TOKEN secret reference.
@github-actions

Copy link
Copy Markdown
Contributor

Quality Report — ConductionNL/stackiq @ 836f8f1

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

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

Download the full PDF report from the workflow artifacts.

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