Redesign homepage: hero section, role cards, Microsoft Blue palette, nav collapse#68
Merged
Redesign homepage: hero section, role cards, Microsoft Blue palette, nav collapse#68
Conversation
…nav collapse - Add gradient hero section with CTAs (Get Started + View Control Catalog) - Add 'By the Numbers' metrics strip (71 controls, 4 pillars, 5 regulations, 3 zones) - Replace text role lists with 5 icon grid cards (added IT Security/InfoSec) - Add Mermaid architecture diagram (Zones -> Pillars -> Regulations) - Upgrade color palette: Microsoft Blue #0078D4 + WCAG AA teal #007A7E - Full dark mode support with complete brand token overrides - Remove navigation.sections (sidebar collapses by default) - Move Readiness Assessment under Getting Started tab - Add What's New tab with in-site changelog page - Add pymdownx.emoji, md_in_html, pymdownx.highlight extensions - Add content.code.copy, navigation.top features - Set font:false (avoid Google Fonts CDN blocked in FSI environments) - Responsive hero/metrics at 600px breakpoint - Hero button overrides scoped to .hero only (no global side effects) - Homepage uses hide:navigation,toc for product landing page pattern Council-reviewed: 5-model AI council (20 findings, all critical/warnings addressed) Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- Switch from TB to LR flow for better readability - Use subgraph-to-subgraph edges (Zones --> Pillars --> Regs) instead of 12 node-to-node edges - Break long node labels with \n instead of cramming into one line - Split regulations into individual nodes for clarity Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Zones/Pillars/Regulations stack vertically with items arranged horizontally within each row. Fits page width without scrolling. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Mermaid couldn't produce uniform-sized, centered nodes. HTML/CSS grid gives pixel-perfect control: - 3 centered rows: Zones (blue), Pillars (teal), Regulations (deep blue) - Uniform card sizes with flex layout - Color-coded by layer using brand tokens - Responsive at 600px breakpoint - Dark mode compatible via brand token overrides Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- Shield shape: universal compliance/security symbol - Circuit/network nodes: represents AI agent governance - Gradient: Microsoft Blue #0078D4 to deep blue #005A9E - Matches site color palette - Applied to both logo.svg and favicon.svg Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Logo (nav bar): white shield pops against blue header bar, blue circuit nodes provide brand color. Same pattern as Azure Portal, M365 Admin. Favicon (browser tab): keeps blue gradient shield with white nodes since it renders on light tab backgrounds. Nodes enlarged and lines thickened for small-size legibility. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Bold-label metadata fields (Purpose:, Applies to:, etc.) separated by <br> in a single paragraph now have visual breathing room: - margin-top: 0.4em between fields - Labels colored with primary brand color for scannability Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Content was consolidated into agent-identity-architecture.md. The old redirect row was the only remaining --strict build warning. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 174110937f
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| --md-default-bg-color: #1B1A19; | ||
| --brand-primary: #429CE3; | ||
| --brand-primary-dark: #005A9E; | ||
| --brand-accent: #3DD6E0; |
There was a problem hiding this comment.
In dark mode, --brand-accent is set to #3DD6E0, but the architecture cards keep color: #fff (see .arch-card/.arch-pillar), which drops text contrast to about 1.8:1 and makes the pillar labels hard to read. This only appears under the slate scheme, but it affects a primary homepage element, so the accent should be darkened for slate (or the card text switched to a dark color) to preserve legibility.
Useful? React with 👍 / 👎.
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
1 participant
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.
Summary
Transform the FSI-AgentGov site from an internal documentation portal to a professional product landing page, based on detailed UX feedback and validated by a 5-model AI council review (20 findings, all addressed).
Changes
Homepage (docs/index.md) — complete rewrite
Theme & branding
Navigation
avigation.sections\ — sidebar sections collapse by default (was forcing 600+ items open)
Extensions & features added
avigation.top\
Bug fixes
AI Council Review
5-model council (Claude Opus, GPT-5.3-Codex, Gemini 3 Pro, Claude Sonnet, GPT-5.2) reviewed the plan before implementation. Key findings addressed:
Build status
\mkdocs build --strict\ passes with zero warnings.
Screenshots
Preview with \mkdocs serve\ to see the full redesign.