From 6afff9ed3e04e4be506a3eac51edbf24550fe225 Mon Sep 17 00:00:00 2001 From: Ruben van der Linde Date: Wed, 13 May 2026 10:00:48 +0200 Subject: [PATCH] refactor(docs): fold 'Using Claude' under 'Hydra' as 'Using Hydra' MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Spotted on docs.conduction.nl after the Phase 3 merge: 'Hydra' and 'Using Claude' rendered as two separate top-level sections in the sidebar, even though they're one product. The pipeline is Hydra; the developer-facing workflow IS using the Hydra pipeline (via Claude Code under the hood, but the brand and the section name should be Hydra). ## Changes - **website/sidebars.js**: nest the former 'Using Claude' category inside the 'Hydra' category and rename to 'Using Hydra'. Order inside Hydra: Pipeline → Operations → Retrospectives → Using Hydra. - **website/docusaurus.config.js**: navbar 'Claude workflow' link renamed to 'Using Hydra' (still pointing at /claude/ — file paths unchanged for now). Footer 'Documentation' column: add 'Hydra' alongside the renamed 'Using Hydra' link. - **docs/claude/README.md**: rewritten intro framing the section as the driver's-seat view of the Hydra pipeline, linking back to the sibling Hydra section for the internals. - **i18n/nl**: navbar/footer/sidebar labels updated — 'Claude workflow' / 'Using Claude' all replaced by 'Hydra gebruiken'. ## What didn't change - **URLs**: `/claude/*` paths are preserved. Moving them to `/hydra/using-hydra/*` would mean 28 file renames + redirects; worth a separate pass if the URL shape matters. The sidebar reorganisation makes the *navigation* unified without disturbing bookmarks. - **Pipeline / Operations / Retrospectives**: same content, same position inside the Hydra category. --- docs/claude/README.md | 6 +- website/docusaurus.config.js | 5 +- .../current.json | 6 +- .../nl/docusaurus-theme-classic/footer.json | 10 +- .../nl/docusaurus-theme-classic/navbar.json | 8 +- website/sidebars.js | 120 +++++++++--------- 6 files changed, 83 insertions(+), 72 deletions(-) diff --git a/docs/claude/README.md b/docs/claude/README.md index 7748e6d..51981bf 100644 --- a/docs/claude/README.md +++ b/docs/claude/README.md @@ -1,6 +1,8 @@ -# Claude Code Developer Guide +# Using Hydra -Documentation for Conduction's spec-driven development workflow, combining OpenSpec, GitHub Issues, and Claude Code. +Developer-facing guide to Conduction's spec-driven workflow. This is the *driver's seat* view of the [Hydra pipeline](../hydra/) — how to set your workstation up, write specs and skills, hand a change off to the pipeline, and run reviews. The pipeline internals (Builder / Reviewer / Applier agents, container architecture, deployment models, operations) are documented in the sibling [Hydra](../hydra/) section. + +Underneath, the tool is **Claude Code** with the Conduction skills catalogue; this section was previously titled *Claude Code Developer Guide* before being folded into the Hydra umbrella. ## Guides diff --git a/website/docusaurus.config.js b/website/docusaurus.config.js index 33d34b3..8b02c08 100644 --- a/website/docusaurus.config.js +++ b/website/docusaurus.config.js @@ -59,8 +59,8 @@ const config = createConfig({ items: [ { to: '/WayOfWork/way-of-work', label: 'Way of Work', position: 'left' }, { href: 'https://github.com/orgs/ConductionNL/projects/4', label: 'Roadmap', position: 'left' }, - { to: '/claude/', label: 'Claude workflow', position: 'left' }, { to: '/hydra/', label: 'Hydra', position: 'left' }, + { to: '/claude/', label: 'Using Hydra', position: 'left' }, { to: '/iso/', label: 'ISO', position: 'left' }, { href: 'https://www.conduction.nl/support/', label: 'Support', position: 'left' }, { href: 'https://www.conduction.nl/apps/', label: 'Products', position: 'left' }, @@ -87,7 +87,8 @@ const config = createConfig({ title: 'Documentation', items: [ { label: 'Roadmap', href: 'https://github.com/orgs/ConductionNL/projects/4' }, - { label: 'Claude workflow', to: '/claude/' }, + { label: 'Hydra', to: '/hydra/' }, + { label: 'Using Hydra', to: '/claude/' }, { label: 'ISO compliance', to: '/iso/' }, ], }, diff --git a/website/i18n/nl/docusaurus-plugin-content-docs/current.json b/website/i18n/nl/docusaurus-plugin-content-docs/current.json index 4cc9edb..6ef39f7 100644 --- a/website/i18n/nl/docusaurus-plugin-content-docs/current.json +++ b/website/i18n/nl/docusaurus-plugin-content-docs/current.json @@ -27,9 +27,9 @@ "message": "Retrospectives", "description": "The label for category Retrospectives in sidebar tutorialSidebar" }, - "sidebar.tutorialSidebar.category.Using Claude": { - "message": "Claude gebruiken", - "description": "The label for category Using Claude in sidebar tutorialSidebar" + "sidebar.tutorialSidebar.category.Using Hydra": { + "message": "Hydra gebruiken", + "description": "The label for category Using Hydra in sidebar tutorialSidebar" }, "sidebar.tutorialSidebar.category.Setup": { "message": "Installatie", diff --git a/website/i18n/nl/docusaurus-theme-classic/footer.json b/website/i18n/nl/docusaurus-theme-classic/footer.json index 5d1cd09..c2d6e54 100644 --- a/website/i18n/nl/docusaurus-theme-classic/footer.json +++ b/website/i18n/nl/docusaurus-theme-classic/footer.json @@ -7,9 +7,13 @@ "message": "Roadmap", "description": "The label of footer link with label=Roadmap" }, - "link.item.label.Claude workflow": { - "message": "Claude-workflow", - "description": "The label of footer link with label=Claude workflow" + "link.item.label.Hydra": { + "message": "Hydra", + "description": "The label of footer link with label=Hydra" + }, + "link.item.label.Using Hydra": { + "message": "Hydra gebruiken", + "description": "The label of footer link with label=Using Hydra" }, "link.item.label.ISO compliance": { "message": "ISO-compliance", diff --git a/website/i18n/nl/docusaurus-theme-classic/navbar.json b/website/i18n/nl/docusaurus-theme-classic/navbar.json index 9e10b62..a3d5d2b 100644 --- a/website/i18n/nl/docusaurus-theme-classic/navbar.json +++ b/website/i18n/nl/docusaurus-theme-classic/navbar.json @@ -7,14 +7,14 @@ "message": "Roadmap", "description": "Navbar item with label Roadmap" }, - "item.label.Claude workflow": { - "message": "Claude-workflow", - "description": "Navbar item with label Claude workflow" - }, "item.label.Hydra": { "message": "Hydra", "description": "Navbar item with label Hydra" }, + "item.label.Using Hydra": { + "message": "Hydra gebruiken", + "description": "Navbar item with label Using Hydra" + }, "item.label.ISO": { "message": "ISO", "description": "Navbar item with label ISO" diff --git a/website/sidebars.js b/website/sidebars.js index 619108c..2ebaa1d 100644 --- a/website/sidebars.js +++ b/website/sidebars.js @@ -42,6 +42,10 @@ const sidebars = { ], }, + /* Hydra is the umbrella for everything pipeline-related: how the + pipeline is built (Pipeline / Operations / Retrospectives) and + how to drive it as a developer (Using Hydra — the former + 'Using Claude' section). They are one product, one section. */ { type: 'category', label: 'Hydra', @@ -74,70 +78,70 @@ const sidebars = { collapsed: true, items: [{ type: 'autogenerated', dirName: 'hydra/retrospectives' }], }, - ], - }, - - { - type: 'category', - label: 'Using Claude', - collapsed: false, - link: { type: 'doc', id: 'claude/README' }, - items: [ - 'claude/getting-started', - 'claude/walkthrough', - 'claude/agents', - 'claude/rad-platform', { type: 'category', - label: 'Setup', - collapsed: true, + label: 'Using Hydra', + collapsed: false, + link: { type: 'doc', id: 'claude/README' }, items: [ - 'claude/workstation-setup', - 'claude/global-claude-settings', - 'claude/docker', - 'claude/playwright-setup', - 'claude/local-llm', - ], - }, - { - type: 'category', - label: 'Workflow', - collapsed: true, - items: [ - 'claude/workflow', - 'claude/app-lifecycle', - 'claude/commands', - 'claude/commands-openspec', - 'claude/commands-tender', - ], - }, - { - type: 'category', - label: 'Writing', - collapsed: true, - items: [ - 'claude/writing-specs', - 'claude/writing-adrs', - 'claude/writing-skills', - 'claude/writing-docs', - 'claude/skill-checklist', - 'claude/skill-patterns', - 'claude/skill-evals', - ], - }, - { - type: 'category', - label: 'Quality & testing', - collapsed: true, - items: [ - 'claude/testing', - 'claude/parallel-agents', - 'claude/frontend-standards', + 'claude/getting-started', + 'claude/walkthrough', + 'claude/agents', + 'claude/rad-platform', + + { + type: 'category', + label: 'Setup', + collapsed: true, + items: [ + 'claude/workstation-setup', + 'claude/global-claude-settings', + 'claude/docker', + 'claude/playwright-setup', + 'claude/local-llm', + ], + }, + { + type: 'category', + label: 'Workflow', + collapsed: true, + items: [ + 'claude/workflow', + 'claude/app-lifecycle', + 'claude/commands', + 'claude/commands-openspec', + 'claude/commands-tender', + ], + }, + { + type: 'category', + label: 'Writing', + collapsed: true, + items: [ + 'claude/writing-specs', + 'claude/writing-adrs', + 'claude/writing-skills', + 'claude/writing-docs', + 'claude/skill-checklist', + 'claude/skill-patterns', + 'claude/skill-evals', + ], + }, + { + type: 'category', + label: 'Quality & testing', + collapsed: true, + items: [ + 'claude/testing', + 'claude/parallel-agents', + 'claude/frontend-standards', + ], + }, + + 'claude/retrofit', ], }, - - 'claude/retrofit', ], },