Skip to content

workshop: Polish pass across site for Camps 1,2 & 3.#77

Merged
dbarkol merged 2 commits into
Azure-Samples:mainfrom
Jitha-afk:main
May 27, 2026
Merged

workshop: Polish pass across site for Camps 1,2 & 3.#77
dbarkol merged 2 commits into
Azure-Samples:mainfrom
Jitha-afk:main

Conversation

@Jitha-afk
Copy link
Copy Markdown
Contributor

Summary

Polish pass across the workshop docs site plus a Camp 1 restructure into multi-section subpages.

Changes

Camp 1 — restructure

  • Split the single docs/camps/camp1-identity.md into a multi-section folder docs/camps/camp1-identity/:
    • index.md, section1-cloud-exploits.md, section2-managed-identity.md, section3-key-vault.md, section4-oauth-jwt.md, section5-validate.md

Camp 2 — polish

  • Updates to index.md, api-governance.md, section1-gateway-governance.md, section2-content-safety.md, section3-network-security.md

Camp 3 — polish + reorder

  • Layer 2 page: unwrapped Output Sanitization out of the Step 2 collapsible into a top-level H2
  • Validate & Key Learnings page: moved What You Built above Validate sections, collapsed Validate 1 / Validate 2 into ??? note blocks, moved the What is PII redaction? admonition inside Validate 2, swapped the ASCII diagram for camp3_whatyoubuilt.png, marked Layer 3 as Optional

Camp 4 — polish

  • What You'll Build diagram rebuilt as RFC-style pure ASCII (64-char width, +/-/|/v only) with column-34 aligned vertical connectors between MCP Client → APIM → Security Function
  • Section 1–4 and reference pages polished

Site-wide

  • Summit page hero image centered and resized to 600px
  • docs/index.md, docs/stylesheets/extra.css, mkdocs.yml updated
  • New diagram/screenshot images under docs/images/ (base camp, camps 1–3)

Ignore agent scaffolding

  • .gitignore now excludes .agents/, .scratch/, skills-lock.json

Verification

  • python -m mkdocs build --strict → clean (no ERROR lines)

JITHA and others added 2 commits May 28, 2026 00:23
…nore agent artifacts

- Split Camp 1 identity page into multi-section subpages (cloud exploits, managed identity, key vault, OAuth/JWT, validate)
- Polish Camp 2/3/4 pages: collapsible blocks, RFC-style ASCII for Camp 4 'What You'll Build', unwrap Output Sanitization in Camp 3, mark Layer 3 optional
- Add new diagram/screenshot images across base camp and camps 1-3
- Center and resize summit page hero image
- Ignore .agents/, .scratch/, skills-lock.json
@Jitha-afk Jitha-afk requested a review from dbarkol May 27, 2026 19:28
@dbarkol dbarkol merged commit 3a8368d into Azure-Samples:main May 27, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants