Conversation
There was a problem hiding this comment.
Pull request overview
This PR reorganizes the MkDocs site navigation and content to better separate “Concepts” from “Reference/Tutorials”, and adds clearer cross-links to production-oriented deployment guidance.
Changes:
- Adds a new Concepts section (Architecture, OOB Management, Remote Provisioning, Control Modes, Security) and wires it into
mkdocs.yml. - Introduces a Tutorials Overview landing page and adds a “production deployment guidance” note to the Scaling overview.
- Refactors the Architecture Overview reference page to be a shorter summary that links to the new Concepts pages, and updates several existing pages to link to the new Security overview.
Reviewed changes
Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.
Show a summary per file
| File | Description |
|---|---|
| mkdocs.yml | Updates site nav to add Concepts section and Tutorials overview entry; removes duplicate “Get Help” groupings. |
| docs/Tutorials/overview.md | Adds a tutorials landing page with quick links/buttons to key tutorial flows. |
| docs/Tutorials/Scaling/overview.md | Adds a note linking scaling readers to Deployment Overview for production component replacement guidance. |
| docs/Reference/architectureOverview.md | Replaces large in-page explanations with a shorter flow/component summary and “Learn More” links into Concepts. |
| docs/Reference/RPC/transitionDeviceRPC.md | Updates password/security reference link to the new Security Overview page. |
| docs/GetStarted/Enterprise/createProfileCCM.md | Updates password/security reference link to the new Security Overview page. |
| docs/GetStarted/Enterprise/createProfileACM.md | Updates password/security reference link to the new Security Overview page. |
| docs/GetStarted/Cloud/createProfileCCM.md | Updates password/security reference link to the new Security Overview page. |
| docs/Concepts/security.md | Adds a security overview page with credential/cert/component/security pointers and production warnings. |
| docs/Concepts/remoteProvisioning.md | Cleans up formatting/links and repositions remote provisioning content under Concepts. |
| docs/Concepts/oobManagement.md | Adds a Concepts page describing OOB vs in-band management plus power/KVM context. |
| docs/Concepts/controlModes.md | Adds a Concepts page explaining ACM vs CCM, consent requirements, and domain considerations. |
| docs/Concepts/architecture.md | Adds a Concepts page describing toolkit components and Cloud vs Enterprise connection models. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
graikhel-intel
approved these changes
Feb 9, 2026
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.
PR Checklist
What are you changing?
Anything the reviewer should know when reviewing this PR?