Conversation
f61f00e to
e8391de
Compare
There was a problem hiding this comment.
Pull request overview
This PR reorganizes the documentation by introducing a new Concepts section for key out-of-band (OOB) and foundational topics, reducing the amount of conceptual material living under Reference, and adding a Tutorials landing page to better orient users.
Changes:
- Updates
mkdocs.ymlnavigation to add a top-level Concepts section and a Tutorials > Overview entry. - Adds new Concepts pages (architecture, OOB management, control modes, security).
- Streamlines
Reference/architectureOverview.mdby replacing large conceptual blocks with links to the new Concepts pages.
Reviewed changes
Copilot reviewed 11 out of 11 changed files in this pull request and generated no comments.
Show a summary per file
| File | Description |
|---|---|
mkdocs.yml |
Adds the Concepts section and Tutorials overview to site navigation; removes duplicated “Get Help” blocks from other tabs. |
docs/Tutorials/overview.md |
New Tutorials landing page with curated entry points and mkdocs-material button links. |
docs/Reference/architectureOverview.md |
Refactors content to focus on architecture overview and links out to Concepts/Logging for deeper explanations. |
docs/Concepts/architecture.md |
New architecture/concepts page consolidating deployment flow, components, and connection models. |
docs/Concepts/oobManagement.md |
New OOB management concept page (in-band vs OOB, power control, KVM). |
docs/Concepts/controlModes.md |
New ACM vs CCM control modes concept page plus domain profile notes and related links. |
docs/Concepts/security.md |
New security overview page with credential guidance and links to component security/cert/secrets references. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
8adcab4 to
bb148e9
Compare
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?
Creates a dedicated concept section to outline important aspects to understand as part of the toolkit. This declutters the "Reference" section a bit.
Anything the reviewer should know when reviewing this PR?