Skip to content
This repository was archived by the owner on May 29, 2026. It is now read-only.

feat(docs): adopt @conduction/docusaurus-preset + move to softwarecatalog.conduction.nl#216

Merged
rubenvdlinde merged 1 commit into
developmentfrom
feature/conduction-nl-migration
May 7, 2026
Merged

feat(docs): adopt @conduction/docusaurus-preset + move to softwarecatalog.conduction.nl#216
rubenvdlinde merged 1 commit into
developmentfrom
feature/conduction-nl-migration

Conversation

@rubenvdlinde

Copy link
Copy Markdown
Contributor

Summary

Adopts the shared @conduction/docusaurus-preset@^1.4.3 for the SoftwareCatalog docs site and moves it to softwarecatalog.conduction.nl. Mirrors the openregister docs migration (canonical example: ConductionNL/openregister#1444) and the mydash precedent.

The docs site now inherits brand defaults (tokens, Navbar/Footer swizzles, KvK/BTW copyright, hex-watermark hero) and gets a brand-aligned landing page composed from <DetailHero> + <WidgetShelf>.

Changes

  • docs/docusaurus.config.js — rewritten to call createConfig() from @conduction/docusaurus-preset. Keeps softwarecatalog-specific bits: NL+EN i18n, mermaid theme, custom prism themes, Documentation + GitHub navbar items. Footer reduced to the brand "Conduction" column via baseFooterLinks().filter(...). minigames: false to drop the canal-footer mini-games on this product-doc surface.
  • docs/package.json + docs/package-lock.json — adds @conduction/docusaurus-preset@^1.4.3.
  • docs/src/pages/index.js — replaces the homepage with <DetailHero> (catalog-grid icon, orange accent, Install / Docs / GitHub CTAs) + a 3-card <WidgetShelf> (Renewals due, Inventory snapshot, Discovery deltas). Authored as .js not .mdx to avoid the docs-plugin/pages-plugin scan collision. Tagline + 3-card composition cited from the connext detail page at design-system/sites/www/src/pages/apps/softwarecatalog.mdx.
  • docs/static/CNAMEsoftwarecatalog.app -> softwarecatalog.conduction.nl.
  • .github/workflows/documentation.ymlcname: updated to softwarecatalog.conduction.nl.

URL change

Production docs URL moves from https://softwarecatalog.app to https://softwarecatalog.conduction.nl. No old hardcoded softwarecatalog.app references in docs/src/; the only mention of "softwarecatalog.app" left in docs/ is a code path (softwarecatalog/appinfo/routes.php) inside docs/CONTACTPERSOON_USER_DETAILS.md, not the domain.

Build

npm run build succeeds locally. Both build/index.html and build/nl/index.html are generated. Broken-link warnings remain for /privacy/, /terms/, /iso/ on the NL locale (the brand preset MDXPage swizzle does not yet ship NL versions of those pages); the build still completes.

i18n

  • en (default), nl. Same locale set as before; no change.

Pre-existing MDX excludes

  • None added beyond **/node_modules/** and src/**. Unlike openregister, the softwarecatalog docs do not contain raw < / {id} characters that the MDX 3 parser rejects, so no per-file excludes were needed.

Test plan

  • Confirm docs/build/index.html and docs/build/nl/index.html render correctly on local preview.
  • Verify the softwarecatalog.conduction.nl DNS / GitHub Pages routing once a maintainer merges and the documentation workflow runs from the documentation branch.
  • Open follow-up issue if the broken NL footer links to /privacy/ / /terms/ / /iso/ need NL surfaces in the brand preset.

Do not admin-merge — leave open for green CI before merge.

…alog.conduction.nl

Adopts the shared @conduction/docusaurus-preset@^1.4.3 for the
SoftwareCatalog docs site and moves it to softwarecatalog.conduction.nl.
Mirrors the openregister docs migration in ConductionNL/openregister#1444
and the mydash precedent.

The docs site now inherits brand defaults (tokens, Navbar/Footer
swizzles, KvK/BTW copyright, hex-watermark hero) and gets a
brand-aligned landing page composed from <DetailHero> + <WidgetShelf>.

Changes
- docs/docusaurus.config.js — rewritten to call createConfig() from
  @conduction/docusaurus-preset. Keeps softwarecatalog-specific bits:
  NL+EN i18n, mermaid theme, custom prism themes, Documentation+GitHub
  navbar items. Footer reduced to the brand "Conduction" column via
  baseFooterLinks().filter(...). minigames: false to drop the
  canal-footer mini-games on this product-doc surface.
- docs/package.json + docs/package-lock.json — adds
  @conduction/docusaurus-preset@^1.4.3.
- docs/src/pages/index.js — replaces the homepage with <DetailHero>
  (catalog-grid icon, orange accent, Install/Docs/GitHub CTAs) + a
  3-card <WidgetShelf> (Renewals due, Inventory snapshot, Discovery
  deltas). Authored as .js not .mdx to avoid the docs-plugin/pages-
  plugin scan collision.
- docs/static/CNAME — softwarecatalog.app -> softwarecatalog.conduction.nl.
- .github/workflows/documentation.yml — cname: updated to
  softwarecatalog.conduction.nl.

URL change
Production docs URL moves from https://softwarecatalog.app to
https://softwarecatalog.conduction.nl. No old hardcoded
softwarecatalog.app references in src/; one mention in
docs/CONTACTPERSOON_USER_DETAILS.md is a code path
(softwarecatalog/appinfo/routes.php), not the domain.
@rubenvdlinde rubenvdlinde merged commit 0d0dbfa into development May 7, 2026
9 of 14 checks passed
@rubenvdlinde rubenvdlinde deleted the feature/conduction-nl-migration branch May 7, 2026 20:50
@github-actions

github-actions Bot commented May 7, 2026

Copy link
Copy Markdown
Contributor

Quality Report — ConductionNL/softwarecatalog @ e7a77b2

Check PHP Vue Security License Tests
lint
phpcs
phpmd
psalm
phpstan
phpmetrics
eslint
stylelint
composer ✅ 120/120
npm
PHPUnit ⏭️
Newman ⏭️
Playwright ⏭️

Quality workflow — 2026-05-07 20:51 UTC

Download the full PDF report from the workflow artifacts.

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