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

docs: scaffold Docusaurus site#39

Merged
rubenvdlinde merged 1 commit into
developmentfrom
feature/docs-site
May 14, 2026
Merged

docs: scaffold Docusaurus site#39
rubenvdlinde merged 1 commit into
developmentfrom
feature/docs-site

Conversation

@rubenvdlinde

Copy link
Copy Markdown
Contributor

Summary

Stands up a Docusaurus docs site for App Versions at app-versions.conduction.nl, scaffolded from the canonical nextcloud-app-template docs/ tree. App Versions is in development; this gives the brand landing surface and the journeydoc tutorial skeleton a stable public home while the admin UI matures.

  • Brand landing page (docs/src/pages/index.js): version-rows glyph, Conduction-voice tagline + lede anchored on the info.xml summary (NOT the stale 'scaffold/template' framing the apps-catalog uses on conduction-website — that's a follow-up to fix there), three token-built mock panels (Installed apps + current version, Available versions per source, Recent rollbacks), 'In development' status pill.
  • Tutorial scaffold: user track collapses to a single 'who is this for' pointer (App Versions is admin-only); admin track gets three intent-stating pages mapped to the canonical specs — 01 first launch, 02 rollback (version-management), 03 connect a GitHub source (external-sources + pat-management).
  • documentation.yml triggers on [documentation] only (canonical post-revert deploy model), cname: app-versions.conduction.nl.
  • docs/static/CNAME, docusaurus.config.js url / editUrl / GitHub link all point at app-versions.

No capture-spec run — there is no admin UI to shoot yet. Reintroduce screenshots together with the implementation PRs.

Test plan

  • PR merged → documentation branch created from development tip → Pages workflow deploys → curl -sI https://app-versions.conduction.nl/ returns HTTP 200.
  • Landing page renders the DetailHero + three mock panels with brand tokens.
  • Tutorial pages render via the autogenerated sidebar with intent-stating placeholder prose; spec links resolve to the openspec/specs/ tree on GitHub.

…elopment)

Stand up the journeydoc docs surface for App Versions. The app is in
development; this PR provides the brand landing page and a tutorial
skeleton anchored on the version-management / external-sources /
pat-management specs, so app-versions.conduction.nl resolves to a real
Docusaurus site while the admin UI matures.

- docs/ tree copied from nextcloud-app-template's canonical scaffold
  (Docusaurus + @conduction/docusaurus-preset 2.6.1, en-only i18n,
  custom prism + mermaid themes, brand-theme swizzles)
- landing page: version-rows glyph, NL-Conduction tagline corrected
  off the info.xml summary (NOT the stale 'scaffold/template' framing
  that lives on conduction-website's apps-catalog), three token-built
  mock panels (Installed apps + current version, Available versions
  per source, Recent rollbacks), 'In development' hero status
- intro.md rewritten to describe what App Versions actually does
  (multi-source version picker, rollback or pin, audit-trailed) and
  links the four canonical specs on GitHub
- user track collapses to a single 'who is this for?' pointer page
  (App Versions is admin-only); admin track gets three intent-stating
  pages mapped to specs: 01 first launch, 02 rollback
  (version-management), 03 connect a GitHub source (external-sources
  + pat-management)
- documentation.yml: triggers on [documentation] only (canonical
  post-revert deploy model), cname app-versions.conduction.nl
- CNAME static + docusaurus.config url / editUrl / GitHub link all
  point at app-versions
@rubenvdlinde rubenvdlinde merged commit 38e31a2 into development May 14, 2026
1 of 10 checks passed
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