hotfix(docs): publish configuration-over-code + atom-card page types to beta#332
Merged
Conversation
…-types - New /docs/architecture/configuration-over-code page framing the manifest + schemas contract as the safe sandbox for AI agents and citizen developers. Links to the academy tutorial on spec-driven development and to conduction.nl/apps/openbuilt. - Manifest page: "Page types" section restructured from a flat table into atom-aware cards (one per type), matching the AtomZones vocabulary used on the app-design-principles page. Each card shows the atom composition (present/off) plus what fills Main and what the Sidebar carries. - Sidebar positions bumped: schemas-and-registers 3 -> 4, customization 4 -> 5, to make room for the new page at position 3. - Landing page: 5th entry-point tile "Configuration over code" added, eyebrow text updated from "Four entry points" to "Five entry points".
- overview.md: replace the Mermaid 3-layer graph with three stacked cn-domain-tree hex diagrams (Your app / @conduction/nextcloud-vue / @nextcloud/vue), middle trunk in orange to mark the layer this site documents. Side-effect import of @conduction/docusaurus-preset/diagrams, wrapped in BrowserOnly for SSR safety. - configuration-over-code.md: rewrite the "Spec-driven development" section around OpenSpec (the real Hydra method): humans write specs + ADRs, AI implements to them; org-wide vs per-app ADR tiers; the /opsx-explore and /opsx-apply skills; ADR-031 declarative business logic with n8n/Windmill via WorkflowEngineInterface; the quality + gatekeeping harness. Was incorrectly framed as the JSON-manifest authoring workflow.
The top-level `import '@conduction/docusaurus-preset/diagrams'` defined web-component classes extending HTMLElement at module-eval during static site generation, where HTMLElement is undefined. Drop the top-level import; require() the diagrams module inside the BrowserOnly render function so it only runs in the browser.
…abels/action/slot Restores CnTimelineView and CnUserActionMenu to 100% JSDoc coverage (part of beta's pre-existing ratchet debt). Adds the missing header slot doc, the five pre-translated label props, the `action` event, and the default slot.
This was referenced May 22, 2026
Contributor
|
🎉 This PR is included in version 1.0.0-beta.70 🎉 The release is available on:
Your semantic-release bot 📦🚀 |
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
Publishes the new architecture docs to the live docs site (nextcloud-vue.conduction.nl deploys from
beta). Same content merged todevelopmentin #331; this is the focusedhotfix/* → betapublish./docs/architecture/configuration-over-code/page (OpenSpec spec-driven framing).CI note — admin merge expected
beta'sCode Quality(JSDoc completeness ratchet) is pre-existing red across ~12 unrelated components (CnCopyDialog, CnDeleteDialog, CnFileManager, CnFormBuilder, CnMass*Dialog, CnNotesCard, CnSchemaFormDialog, CnTreeView, …). That debt is not introduced by this PR — this PR reduces it by 2 components. The docusaurus SSG build and branch-protection pass. Merging via admin to bypass the pre-existing ratchet failure; broader beta JSDoc cleanup tracked separately.Test plan
npx docusaurus buildsucceeds (SSG, no HTMLElement error) — verified locally.