Skip to content

refactor(docs): fold 'Using Claude' under 'Hydra' as 'Using Hydra'#68

Merged
rubenvdlinde merged 1 commit into
mainfrom
chore/unify-hydra-and-using-claude-sidebar
May 13, 2026
Merged

refactor(docs): fold 'Using Claude' under 'Hydra' as 'Using Hydra'#68
rubenvdlinde merged 1 commit into
mainfrom
chore/unify-hydra-and-using-claude-sidebar

Conversation

@rubenvdlinde
Copy link
Copy Markdown
Contributor

Spotted on docs.conduction.nl after PR #67 merged: Hydra and Using Claude rendered as two separate top-level sidebar sections, even though they're one product.

This PR nests the former Using Claude category inside Hydra and renames it to Using Hydra. Navbar + footer labels follow suit. URLs (/claude/*) are preserved — file moves would mean 28 renames + redirects; the sidebar reorganisation makes the navigation unified without breaking bookmarks.

Sidebar — after

Hydra (collapsed=false, links to hydra/README)
├── Pipeline (collapsed)
│   └── pipeline-overview, agentic-workflow, agent-configuration,
│       container-architecture, deployment-models, github-workflow,
│       context
├── Operations (collapsed, auto)
├── Retrospectives (collapsed, auto)
└── Using Hydra (collapsed=false, links to claude/README)
    ├── getting-started, walkthrough, agents, rad-platform
    ├── Setup (collapsed)
    ├── Workflow (collapsed)
    ├── Writing (collapsed)
    ├── Quality & testing (collapsed)
    └── retrofit

Test plan

  • npm run build — succeeds; same broken-anchor warning as before (pre-existing in using-claude/README content)
  • Visual check post-merge once docs.conduction.nl rebuilds

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.
@rubenvdlinde rubenvdlinde merged commit 84f40a4 into main May 13, 2026
3 checks passed
@rubenvdlinde rubenvdlinde deleted the chore/unify-hydra-and-using-claude-sidebar branch May 13, 2026 08:01
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