DOCS-2997: Add the L2 bridge networking page structure - #2943
Merged
Conversation
Add the page structure for L2 bridge networking in Calico Enterprise next. This commit adds the category, the sidebar entries, and a skeleton for each page. Each skeleton carries its headings and a short note under each heading that says what the section covers. The page bodies follow in later commits, one commit per page. Add the feature-status entry so the tech preview status renders in the feature status table. The support and limitations page lives under reference, but appears in the L2 bridge category in the sidebar so readers meet it beside the pages that cite it. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
✅ Deploy Preview for calico-docs-preview-next ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
✅ Deploy Preview succeeded!Built without sensitive environment variables
To edit notification comments on pull requests, go to your Netlify project configuration. |
Collaborator
Author
Contributor
There was a problem hiding this comment.
Pull request overview
Adds the initial documentation IA (information architecture) and page scaffolding for Calico Enterprise “L2 bridge networking” in the “next” docs set, including sidebar wiring and feature-status metadata so the tech preview status can render in feature tables.
Changes:
- Adds a new L2 bridge networking category (with landing page) and wires it into the Calico Enterprise sidebar.
- Introduces MDX skeleton pages for the L2 bridge docs set (concept, setup guides, VM identity, troubleshooting) plus a support/limitations reference page.
- Adds a
feature-status.yamlentry for L2 bridge networking as tech preview in Calico Enterprise 3.24.
Reviewed changes
Copilot reviewed 9 out of 9 changed files in this pull request and generated 2 comments.
Show a summary per file
| File | Description |
|---|---|
| sidebars-calico-enterprise.js | Adds the new “L2 bridge networking” category and page entries to the Calico Enterprise sidebar. |
| data/feature-status.yaml | Registers the L2 bridge networking feature as tech preview for Calico Enterprise 3.24. |
| calico-enterprise/reference/l2-bridge-support.mdx | Adds a new reference page skeleton for L2 bridge support and limitations. |
| calico-enterprise/networking/l2-bridge/index.mdx | Adds the L2 bridge category landing page (DocCardList-based). |
| calico-enterprise/networking/l2-bridge/about-l2-bridge.mdx | Adds the concept/overview page skeleton for L2 bridge networking. |
| calico-enterprise/networking/l2-bridge/connect-vlan.mdx | Adds the “Calico-managed bridge” setup guide skeleton for connecting to an existing VLAN. |
| calico-enterprise/networking/l2-bridge/byo-bridge.mdx | Adds the “bring your own bridge” setup guide skeleton. |
| calico-enterprise/networking/l2-bridge/vm-identity.mdx | Adds the VM identity (retain IP/MAC) guide skeleton. |
| calico-enterprise/networking/l2-bridge/troubleshoot.mdx | Adds the troubleshooting guide skeleton for L2 bridge connectivity issues. |
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
Comment on lines
+6
to
+11
| # L2 bridge networking | ||
|
|
||
| import DocCardList from '@theme/DocCardList'; | ||
| import { useCurrentSidebarCategory } from '@docusaurus/theme-common'; | ||
|
|
||
| <DocCardList items={useCurrentSidebarCategory().items} /> |
Comment on lines
+15
to
+19
| ## Status | ||
|
|
||
| ## Data plane support | ||
|
|
||
| ## Platform requirements |
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.
Adds the page structure for L2 bridge networking in Calico Enterprise next. This is the first of a sequence of PRs. It lands the architecture so the page PRs that follow can each be reviewed on their own.
What this PR does:
Each skeleton carries its headings and a short note under each heading saying what the section covers, so this reviews as an outline. The page bodies follow in later PRs, in the order a reader needs them: concept, then support and limitations, then the two setup guides, then VM identity, then troubleshooting, then the API reference.
Two things worth a reviewer's attention:
The plan behind this sequence, including the user stories each page serves and the open questions still with engineering, is tracked in DOCS-2997.