Skip to content

docs: move Agentic Development into its own top-level section - #6711

Merged
peholmst merged 2 commits into
mainfrom
claude/agentic-dev-section-restructure-469ec6
Nov 19, 2026
Merged

peholmst merged 2 commits into
mainfrom
claude/agentic-dev-section-restructure-469ec6

Conversation

@peholmst

Copy link
Copy Markdown
Member

Moves articles/building-apps/agentic-development to articles/agentic-development, so Agentic Development becomes its own top-level section between Building Apps and the Reference Guide. The pages themselves are unchanged apart from their links.

Changes

  • Move: the whole section, images included, moves with git mv. Its pages are now served under /agentic-development/….
  • Navigation order: Building Apps and the Reference Guide both had order: 10, so their relative order depended on the publisher's tie-break. The new section gets order: 15 and the Reference Guide order: 20, so the three sections now have distinct order values. The section index also gets section-nav: flat, like the other top-level sections.
  • Cross references: every {articles}/building-apps/agentic-development link now points to the new path, both inside the section and on the pages that link to it. The llms-txt links on the docs landing page are updated too.
  • Redirects: each of the 23 old page URLs redirects to its new location. The existing redirects into the old section (the earlier /building-apps/mcp/… URLs and windsurf) now point straight at the new location, so none of them chain.
  • Guidelines: guidelines/information-architecture.md lists the new section.

Checks

  • npm run check-redirects passes.
  • All cross references, images and llms-txt links in the changed pages point to existing files.
  • Vale flags one changed line, the llms-txt line in articles/index.adoc. It's a false positive: Vale reads the mcp.vaadin.com host name as "vaadin", and it flagged the line before this change too.

For reviewers

  • The navigation order hasn't been checked in a rendered build. Please check it in the preview deploy.
  • This could also go to the published 25.3 docs with the target/v25.3 label. The label is left off because that's a call about the release's navigation.

🤖 Generated with Claude Code

Agentic Development was a subsection of Building Apps. It now has its own
top-level section, between Building Apps and the Reference Guide.

Building Apps and the Reference Guide both had order 10, so their order
depended on the publisher's tie-break. The new section gets order 15 and
the Reference Guide order 20, which fixes the order of all three.

Every old page URL redirects to its new location, and the existing
redirects into the old section point straight at the new one.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

@vaadin-review-bot vaadin-review-bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewed the changes — left 1 comment.

Finding
⚠️ The guidelines list the new section but never say which type of documentation it holds

Comment thread guidelines/information-architecture.md Resolved
The guidelines listed the new section but not the types of documentation
it holds, and CONVENTIONS.md still sent all how-to content to Building
Apps. List the section under both how-to guides and reference manuals,
and say where content about AI coding agents goes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown
Contributor

Preview Deployment

This PR has been deployed for preview.

URL: https://docs-preview-pr-6711.fly.dev

Changed pages

Added content is highlighted in green; removed content is marked in red on each page.

Other changed files

  • articles/agentic-development/mcp/claude-logo.svg (renamed)
  • articles/agentic-development/mcp/codex-logo.svg (renamed)
  • articles/agentic-development/mcp/cursor-logo.svg (renamed)
  • articles/agentic-development/mcp/devin-desktop-logo.svg (renamed)
  • articles/agentic-development/mcp/gemini-logo.svg (renamed)
  • articles/agentic-development/mcp/gh-copilot-logo.svg (renamed)
  • articles/agentic-development/mcp/junie-logo.svg (renamed)
  • articles/agentic-development/mcp/opencode-logo.svg (renamed)

Built from bf63119

@peholmst
peholmst merged commit 083b7d4 into main Nov 19, 2026
11 checks passed
@peholmst
peholmst deleted the claude/agentic-dev-section-restructure-469ec6 branch November 19, 2026 14:55
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.

2 participants