Repository navigation
docs: move Agentic Development into its own top-level section - #6711
Merged
Merged
Conversation
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
left a comment
There was a problem hiding this comment.
Reviewed the changes — left 1 comment.
| Finding | |
|---|---|
| The guidelines list the new section but never say which type of documentation it holds |
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>
Contributor
Preview DeploymentThis PR has been deployed for preview. URL: https://docs-preview-pr-6711.fly.dev Changed pagesAdded content is highlighted in green; removed content is marked in red on each page.
Other changed files
Built from bf63119 |
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
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.
Moves
articles/building-apps/agentic-developmenttoarticles/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
git mv. Its pages are now served under/agentic-development/….order: 10, so their relative order depended on the publisher's tie-break. The new section getsorder: 15and the Reference Guideorder: 20, so the three sections now have distinct order values. The section index also getssection-nav: flat, like the other top-level sections.{articles}/building-apps/agentic-developmentlink now points to the new path, both inside the section and on the pages that link to it. Thellms-txtlinks on the docs landing page are updated too./building-apps/mcp/…URLs andwindsurf) now point straight at the new location, so none of them chain.guidelines/information-architecture.mdlists the new section.Checks
npm run check-redirectspasses.llms-txtlinks in the changed pages point to existing files.llms-txtline inarticles/index.adoc. It's a false positive: Vale reads themcp.vaadin.comhost name as "vaadin", and it flagged the line before this change too.For reviewers
target/v25.3label. The label is left off because that's a call about the release's navigation.🤖 Generated with Claude Code