chore(docs): consolidate docusaurus/ into docs/ for fleet consistency - #779
Merged
Conversation
Brings openconnector in line with the rest of the fleet (openregister, opencatalogi, mydash, decidesk, etc.) where docs/ is a self-contained Docusaurus site: config, sidebars, src, static, blog, and content all in one directory. Supersedes the stale PR #690 that attempted the same migration in March. What moved - docusaurus/.gitignore, blog/, docusaurus.config.js, package.json, package-lock.json, sidebars.js, src/, static/ -> docs/ - docusaurus/README.md (Docusaurus boilerplate) removed; the existing docs/README.md is content that the build renders. What changed - docs/docusaurus.config.js: docs.path '../docs' -> './', because Docusaurus.config.js now lives in the same directory as the content. Added src/, static/, blog/ to exclude so the docs plugin doesn't try to render them as markdown content. Comment updated to document the new fleet-standard layout. - .github/workflows/documentation.yml: source-folder 'docusaurus' -> 'docs', so the centralised ConductionNL/.github documentation workflow builds the right directory. - README.md: tree comment simplified to reflect the single docs/ dir. Verification - All git mvs detected as renames (69 R + 1 D + 2 M). - No remaining path references to docusaurus/ except a single historical comment in docs/docusaurus.config.js documenting the migration. - preset is already at ^3.5.0 and the postbuild validator is wired via the bin command (from the recent fleet sweep). Next: after this merges to development, the documentation branch needs the same change before the next openconnector.conduction.nl deploy. That sync is a separate fast-forward / merge.
rubenvdlinde
requested review from
Rem-Dam,
SudoThijn,
WilcoLouwerse,
bbrands02,
remko48 and
rjzondervan
as code owners
May 18, 2026 19:42
3 tasks
Contributor
Quality Report — ConductionNL/openconnector @
|
| Check | PHP | Vue | Security | License | Tests |
|---|---|---|---|---|---|
| lint | ✅ | ||||
| phpcs | ❌ | ||||
| phpmd | ✅ | ||||
| psalm | ✅ | ||||
| phpstan | ✅ | ||||
| phpmetrics | ❌ | ||||
| eslint | ❌ | ||||
| stylelint | ❌ | ||||
| composer | ✅ | ✅ 148/148 | |||
| npm | ❌ | ❌ | |||
| PHPUnit | ⏭️ | ||||
| Newman | ⏭️ | ||||
| Playwright | ⏭️ |
Quality workflow — 2026-05-18 19:43 UTC
Download the full PDF report from the workflow artifacts.
rubenvdlinde
added a commit
that referenced
this pull request
May 19, 2026
The docusaurus -> docs rename landed via PR #779 + sync #780, but the documentation branch's workflow file still pointed source-folder at the old 'docusaurus' path. The deploy runner kept hitting 'cd: docusaurus: No such file or directory' and exiting 1. This is a one-line workflow fix applied directly on documentation so the deploy retries with the correct path. development was already correct from #779; this commit brings documentation in line.
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
Brings openconnector in line with the rest of the fleet (openregister, opencatalogi, mydash, decidesk, ...) where `docs/` is a self-contained Docusaurus site: config, sidebars, src, static, blog, and content all in one directory.
Supersedes the stale PR #690 which attempted the same migration in March and has been untouched since.
What moved
What changed
Diff stats
git mv)Out of scope
The `documentation` branch (which the deploy actually fires from) still has the old layout. After this PR merges into `development`, the same migration needs to propagate to `documentation` before the next deploy. That's a separate fast-forward/merge PR.
Test plan