Skip to content

feat(docs): move the docs host softwarecatalog.conduction.nl -> stackiq.conduction.nl - #711

Merged
rubenvdlinde merged 1 commit into
developmentfrom
feat/docs-host-to-stackiq
Aug 24, 2026
Merged

feat(docs): move the docs host softwarecatalog.conduction.nl -> stackiq.conduction.nl#711
rubenvdlinde merged 1 commit into
developmentfrom
feat/docs-host-to-stackiq

Conversation

@rubenvdlinde

Copy link
Copy Markdown
Contributor

What

Moves this app's documentation host from the old name to the new one, and stops
the docs linking to Codeberg.

Why it was frozen, and what changed

Every documentationUrl, docs/static/CNAME and docusaurus url: in this repo
was deliberately left on the old host, with comments saying so. That was correct:
the new hostname did not resolve at all — no DNS record, not a 404.

It resolves as of 2026-08-23. Each new hostname was attached as a second
custom domain on the same <old>-docs Worker
that already served the old one,
so both hosts answer and nothing goes dark in either direction. Verified: all 14
new hosts return 200, and all 14 old hosts still return 200.

docs-hosts lists BOTH hosts, and that is load-bearing

wrangler reconciles a Worker's triggers against the config it is handed. A
hostname omitted from routes is removed from the Worker — which takes that
site down.

This is not theoretical: on the same day, a deploy without workers_dev in the
file silently disabled the workers.dev URL (200 → 404) while reporting
success. The warning scrolled past in the output and the command exited 0.

So the caller now passes every host this site answers on. See
ConductionNL/.github#555 for the input.

Codeberg → GitHub

GitHub is the only host, including for issues. The published navbar was offering
a Codeberg link, and editUrl pointed at Codeberg's browse path.

This will not be visible until .github#555 lands

The reusable documentation workflow writes gh-pages and never touches the
Worker that actually serves the host — and the step after it prints
"Deployment completed" with the gh-pages commit, so it has reported success on
every run.

Measured last Worker deployment: openbuild-docs 2026-06-26, procest-docs
2026-06-06, hrmq-docs 2026-06-03, scholiq-docs and softwarecatalog-docs
2026-05-30. Every fleet docs site has been serving a May/June build.

That is also why buildiq.conduction.nl renders "OpenBuild" with a broken
glyph, despite the source having said appId="buildiq" since the app-id rename
merged. The docs were not missed by the rename — they were never republished.

…odeberg

The `<new>.conduction.nl` docs hosts did not exist until 2026-08-23, which is
why every documentationUrl, CNAME and docusaurus `url:` in this repo was
deliberately frozen on the old host. They exist now: each new hostname was
attached as a SECOND custom domain on the SAME `<old>-docs` worker, so both
hosts answer and nothing goes dark in either direction.

`docs-hosts` lists BOTH hosts on purpose. wrangler reconciles a worker's
triggers against the config it is handed, so a hostname omitted there is REMOVED
from the worker — which would take that site down. (Observed the same day: a
deploy without `workers_dev` in the file silently disabled the workers.dev URL,
404 where it had been 200, while reporting success.)

Codeberg links in docs/ now point at GitHub. GitHub is the only host, including
for issues, and the navbar on the published site was offering Codeberg.

The docs will only actually change once ConductionNL/.github#555 lands: the
reusable documentation workflow writes gh-pages and never touches the worker
that serves the host, so every fleet docs site has been serving a May/June build
while reporting success on each run.
@github-actions

Copy link
Copy Markdown
Contributor

Quality Report — ConductionNL/stackiq @ 98dec70

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

Quality workflow — 2026-08-23 20:29 UTC

Download the full PDF report from the workflow artifacts.

@rubenvdlinde
rubenvdlinde merged commit 902385c into development Aug 24, 2026
81 checks passed
@rubenvdlinde
rubenvdlinde deleted the feat/docs-host-to-stackiq branch August 24, 2026 00:12
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