Skip to content

docs: documentation site and project notes - #2

Merged
rubenvdlinde merged 2 commits into
developmentfrom
feature/docs-site
Nov 16, 2026
Merged

rubenvdlinde merged 2 commits into
developmentfrom
feature/docs-site

Conversation

@rubenvdlinde

Copy link
Copy Markdown
Contributor

Adds the documentation site for archiefmeta.conduction.nl and makes this repo the home of the project notes for "Nextcloud archiefwaardige opslag, iteratie 1".

What changes

  • docs/ is now a Docusaurus project on @conduction/docusaurus-preset, English locale only, blog off.
  • .github/workflows/documentation.yml calls the shared Documentation workflow. It passes CF_API_TOKEN and CF_ACCOUNT_ID explicitly, with cname, docs-hosts and a pinned worker-name: archiefmeta-docs.
  • Sidebar: Introduction, User and admin guide (with the demo script), Architecture, Project: archiefwaardige opslag (Dutch: D1 analysis, progress notes, state towards Nextcloud, MDTO alignment), Evidence (S3 Object Lock deletes, PROPPATCH refused).
  • Dutch pages wrap their body in <div lang="nl"> (WCAG 3.1.2).
  • The evidence for Let a storage backend refuse or defer a deletion, with a reason shown to the user nextcloud/server#66498 is published with every credential replaced by <redacted>.
  • tests/Integration/live-test.sh no longer has default credentials. They must now be set as environment variables.
  • The README links to the site. The existing docs pages moved to docs/guide/demo.md and docs/evidence/proppatch-refused.md.

Verified locally

  • COMPOSER_PROCESS_TIMEOUT=0 composer check: green, 54 tests.
  • npm run lint: green.
  • cd docs && npm ci --legacy-peer-deps && npm run build: green. Broken links fail the build.
  • Grep of the tree and the branch diff for em-dashes, the excluded product names and the test credentials: no hits.

Known

The test credentials remain in the history of development (commit 512b9df, PR #1). This PR removes them from the tree only. They belong to a local test environment bound to 127.0.0.1.

The site and this PR were written with AI assistance (Claude Code).

🤖 Generated with Claude Code

…ng them

The live test defaulted to the passwords and S3 keys of the local test
environment. They now have to be set through environment variables.

Assisted-by: ClaudeCode:claude-opus-5-5
Docusaurus site on @conduction/docusaurus-preset, published to
archiefmeta.conduction.nl by the shared Documentation workflow. It holds
the user and admin guide, the architecture, the evidence of the test
runs, and the project notes of the assignment archiefwaardige opslag in
Dutch: D1 analysis, progress notes, state towards Nextcloud and MDTO
alignment. Dutch pages carry lang="nl".

Assisted-by: ClaudeCode:claude-opus-5-5
@rubenvdlinde
rubenvdlinde merged commit 341ff41 into development Nov 16, 2026
2 checks passed
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