Installation updates, Microsoft Insights user guide, and link fixes - #78
Merged
Conversation
…tallationUpdates2 Installation improvements, Microsoft Insights addition, & deadlink up…
There was a problem hiding this comment.
Pull request overview
This PR updates the documentation site navigation and SHIELD docs to reflect updated installation prerequisites, fixes/modernizes several internal links, and introduces a new Microsoft Insights usage guide.
Changes:
- Adds “Microsoft Insights” to site navigation and publishes a new Microsoft Insights Usage Guide page.
- Updates SHIELD installation prerequisites and expands step-by-step setup guidance.
- Replaces outdated “Deployment Guide / Getting Started” references with “Overview and Installation Requirements” links across SHIELD docs.
Reviewed changes
Copilot reviewed 10 out of 24 changed files in this pull request and generated 4 comments.
Show a summary per file
| File | Description |
|---|---|
zensical.toml |
Adds Microsoft Insights to the docs nav and enables pymdownx.critic. |
docs/SHIELD/Usage-Guide.md |
Updates link to point to the installation prerequisites page. |
docs/SHIELD/Prerequisites/Installation.md |
Expands and restructures installation prerequisites and deployment steps. |
docs/SHIELD/Prerequisites/index.md |
Formatting cleanup and updates related-page link to the installation prerequisites. |
docs/SHIELD/Deploy/Usage-Guide.md |
Updates related-page link to the installation prerequisites. |
docs/SHIELD/Deploy/index.md |
Updates related-page link to the installation prerequisites. |
docs/SHIELD/Deploy/Deployment/index.md |
Updates related-page link to the installation prerequisites. |
docs/SHIELD/Defend/Reference/index.md |
Replaces a placeholder link with “coming soon” text. |
docs/SHIELD/Defend/Deployment.md |
Updates related-page link to the installation prerequisites. |
docs/Microsoft-Insights/Usage-Guide.md |
Adds new Microsoft Insights usage documentation with screenshots and glossary. |
Suppressed comments (1)
docs/Microsoft-Insights/Usage-Guide.md:205
- Same as above: use the trailing-slash form for this internal absolute link to keep URLs consistent and avoid redirect/link-check issues.
- If SHIELD is not installed in your environment, the system will not be able to display any insights in the report. For steps to install SHIELD, see [Overview and Installation Requirements](/SHIELD/Prerequisites/Installation).
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
Jonny Pound (JonnyPound90)
approved these changes
Aug 21, 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.
No description provided.