feat(docs): adopt @conduction/docusaurus-preset + move to procest.conduction.nl#316
Merged
rubenvdlinde merged 1 commit intodevelopmentfrom May 7, 2026
Merged
Conversation
…duction.nl Migrates the Procest documentation site from procest.app to procest.conduction.nl and adopts @conduction/docusaurus-preset@^1.4.3 for shared brand defaults (tokens, theme swizzles, KvK / BTW footer copyright). Mirrors the docudesk migration since both apps embed an in-app reference to the docs URL. - docs/docusaurus.config.js: rewritten through createConfig() with brand theme + theme-mermaid, en + nl locales preserved, footer reduced to the brand Conduction column, minigames disabled, src/** excluded from plugin-content-docs to avoid the MDX-parser collision with plugin-content-pages. - docs/package.json: adds @conduction/docusaurus-preset@^1.4.3. Lockfile refreshed. - docs/static/CNAME: procest.conduction.nl. - .github/workflows/documentation.yml: cname updated. - docs/src/pages/index.js: replaced the legacy hero with the brand DetailHero + WidgetShelf composition, mirroring the connext detail page (clock-face icon, orange accent, three widgets reflecting Procest's value: werkvoorraad, deadlines, recent decisions). In-app fix: - src/views/settings/Settings.vue: doc-url switched from https://procest.app to https://procest.conduction.nl/docs/intro so the Settings panel deep-links into the new docs site.
rubenvdlinde
requested review from
Rem-Dam,
SudoThijn,
WilcoLouwerse,
bbrands02,
remko48 and
rjzondervan
as code owners
Contributor
Quality Report — ConductionNL/procest @
|
| Check | PHP | Vue | Security | License | Tests |
|---|---|---|---|---|---|
| lint | ✅ | ||||
| phpcs | ❌ | ||||
| phpmd | ✅ | ||||
| psalm | ✅ | ||||
| phpstan | ✅ | ||||
| phpmetrics | ✅ | ||||
| eslint | ❌ | ||||
| stylelint | ❌ | ||||
| composer | ✅ | ✅ 100/100 | |||
| npm | ❌ | ❌ | |||
| PHPUnit | ⏭️ | ||||
| Newman | ⏭️ | ||||
| Playwright | ⏭️ |
Quality workflow — 2026-05-07 20:52 UTC
Download the full PDF report from the workflow artifacts.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
procest.apptoprocest.conduction.nl, adopting@conduction/docusaurus-preset@^1.4.3for shared brand defaults (tokens, theme swizzles for Navbar / Footer, KvK / BTW copyright). Mirrors the docudesk migration and openregister PR #1444 since Procest also has an in-app reference to the docs URL.docs/docusaurus.config.jsthroughcreateConfig()with the brand theme +theme-mermaid, preservesen+nllocales, reduces the footer to the brand Conduction column, disables minigames, and excludessrc/**fromplugin-content-docs(preset 1.4.x convention to keep MDX-ESM out ofplugin-content-pagesterritory).docs/src/pages/index.jswith aDetailHero+WidgetShelflanding mirroring the connext detail page atdesign-system/sites/www/src/pages/apps/procest.mdx: clock-face icon,iconColor: var(--c-orange-knvb), three widget cards (Werkvoorraad, Deadlines, Recent decisions).docs/static/CNAMEand.github/workflows/documentation.yml(cname: procest.conduction.nl), and updates the lockfile to pull the new preset.src/views/settings/Settings.vuehad adoc-url="https://procest.app"attribute on the<CnSettingsSection>component. Switched tohttps://procest.conduction.nl/docs/introso the in-app Settings deep-link reaches the migrated docs site. (Noprocest.appreference exists insrc/store/store.jsafter a full repo grep — the only in-app occurrence was the Settings.vue one above.)Locales
en(default),nl. Both locales build cleanly under the new preset.Build verification
Ran
cd docs && npm install --legacy-peer-deps --no-audit --no-fund && npm run buildlocally. Bothbuild/(en) andbuild/nl/(nl) generated successfully. Pre-existingonBrokenLinks: 'warn'surfaces a handful of/privacy/,/terms/,/iso/warnings sourced from the preset footer; these are warnings, not errors, and predate this change.No
docs.excludeentries were needed beyond the standardsrc/**+node_modules/**(no broken pre-existing MDX in this repo to skip).Test plan
procest.conduction.nlresolves to GitHub Pages./docs/introfrom inside Procest's Settings panel and verify the new site loads./.Do not admin-merge — leave open until CI + DNS check.