Skip to content

Docs/content updates and bugfixes#37

Merged
arnaudlh merged 2 commits intoAzure:mainfrom
arnaudlh:docs/content-updates-and-bugfixes
Apr 29, 2026
Merged

Docs/content updates and bugfixes#37
arnaudlh merged 2 commits intoAzure:mainfrom
arnaudlh:docs/content-updates-and-bugfixes

Conversation

@arnaudlh
Copy link
Copy Markdown
Member

Key changes:

Documentation Modernization and Cleanup

  • Removed several local documentation files (docs/AZURE_MCP_SETUP.md, docs/CODESPACES.md, docs/EXAMPLES.md) and replaced them with links to the new website for setup guides, examples, and onboarding documentation in README.md. This reduces duplication and ensures users get the latest information. [1] [2] [3] [4] [5]

Diagram and Visualization Enhancements

  • Added color-coded classDef styles to Mermaid diagrams in .github/agents/azure-template-generator.agent.md and .github/skills/azure-resource-visualizer/SKILL.md to visually distinguish resource types (internet, compute, storage, data, monitor, etc.), improving diagram readability for Azure architectures. [1] [2] [3] [4]
  • Updated generated diagrams in scripts/generate-docs.js to include similar classDef styling for orchestrators, pipelines, gates, advisories, and utilities, and for skill phase groupings (pre, post, ops). [1] [2]

Auto-Generated Documentation Improvements

  • Refined the insertion of auto-generated comments in documentation files to ensure Docusaurus frontmatter is not disrupted, improving compatibility with documentation tooling. [1] [2]

Minor Asset Reference Fix

  • Fixed the README logo path to reference APE.png in the root directory instead of docs/APE.png.

These changes collectively improve the user and contributor experience by making documentation more accessible, visually intuitive, and easier to maintain.

- update generated docs for agents, skills, and workflows
- fix docusaurus.config.ts and sidebars.ts configuration
- improve generate-docs.js script and drift-detection docs
- remove unused Docusaurus placeholder images

📝 - Generated by Copilot
…om + colors

- add Vision & Manifesto page from devblogs article
- consolidate workload examples into single deploy-anything page
- restructure landing: hero tagline, capability tiles, video, comparison
- rename persona pages to .mdx so JSX components render correctly
- add click-to-zoom modal for all mermaid diagrams (mobile-aware)
- color all 37 mermaid diagrams; ensure visibility in dark mode
- new ape favicon + logo from APE.png; ignore .playwright-mcp/

📝 - Generated by Copilot
@arnaudlh arnaudlh requested a review from sendtoshailesh April 29, 2026 04:17
@arnaudlh arnaudlh added the documentation Improvements or additions to documentation label Apr 29, 2026
@arnaudlh arnaudlh self-assigned this Apr 29, 2026
@arnaudlh arnaudlh merged commit a261b36 into Azure:main Apr 29, 2026
2 checks passed
@arnaudlh arnaudlh deleted the docs/content-updates-and-bugfixes branch April 29, 2026 05:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants