mkdocs.yml

site_name: MCP Security Summit Workshop
site_url: https://azure-samples.github.io/sherpa
site_description: A Sherpa's Guide to Securing Model Context Protocol Servers in Azure
site_author: Microsoft Azure Samples
repo_name: Azure-Samples/sherpa
repo_url: https://github.com/Azure-Samples/sherpa
edit_uri: edit/main/

# Copyright
copyright: Copyright © 2025 Microsoft Corporation

theme:
  name: material
  custom_dir: docs/overrides
  logo: sherpa-icon.png
  favicon: sherpa-icon.png
  language: en
  palette:
    # Light mode
    - scheme: default
      primary: blue-grey
      accent: blue-grey
      toggle:
        icon: material/brightness-7
        name: Switch to dark mode
    # Dark mode
    - scheme: slate
      primary: blue-grey
      accent: blue-grey
      toggle:
        icon: material/brightness-4
        name: Switch to light mode
  font:
    text: Roboto
    code: Roboto Mono
  features:
    - navigation.instant
    - navigation.tracking
    - navigation.tabs
    - navigation.top
    - navigation.footer
    - search.suggest
    - search.highlight
    - content.code.copy
    - content.code.annotate
    - content.tabs.link
  icon:
    repo: fontawesome/brands/github

# Extensions
markdown_extensions:
  - admonition
  - pymdownx.details
  - pymdownx.superfences
  - pymdownx.tabbed:
      alternate_style: true
  - pymdownx.highlight:
      anchor_linenums: true
      line_spans: __span
      pygments_lang_class: true
  - pymdownx.inlinehilite
  - pymdownx.snippets
  - pymdownx.emoji:
      emoji_index: !!python/name:material.extensions.emoji.twemoji
      emoji_generator: !!python/name:material.extensions.emoji.to_svg
  - attr_list
  - md_in_html
  - tables
  - toc:
      permalink: true

# Navigation
nav:
  - Home: index.md
  - Prerequisites: prerequisites.md
  - The Journey:
    - Base Camp: camps/base-camp.md
    - Camp 1 - Identity: camps/camp1-identity.md
    - Camp 2 - Gateway:
      - "Overview & Deploy": camps/camp2-gateway/index.md
      - Gateway & Authentication: camps/camp2-gateway/section1-gateway-governance.md
      - API Governance: camps/camp2-gateway/api-governance.md
      - Content Safety: camps/camp2-gateway/section2-content-safety.md
      - Network Security: camps/camp2-gateway/section3-network-security.md
    - Camp 3 - I/O Security:
      - "Overview & Deploy": camps/camp3-io-security/index.md
      - Understand Vulnerabilities: camps/camp3-io-security/section1-vulnerabilities.md
      - Layer 2 Security: camps/camp3-io-security/section2-layer2-security.md
      - Validate & Key Learnings: camps/camp3-io-security/section3-validation.md
    - Camp 4 - Monitoring:
      - "Overview & Deploy": camps/camp4-monitoring/index.md
      - Gateway Logging: camps/camp4-monitoring/section1-apim-logging.md
      - Function Observability: camps/camp4-monitoring/section2-function-observability.md
      - Dashboards & Alerts: camps/camp4-monitoring/section3-dashboards-alerts.md
      - Incident Response: camps/camp4-monitoring/section4-incident-response.md
      - Production Deployment: camps/camp4-monitoring/production-deploy.md
      - Reference: camps/camp4-monitoring/reference.md
    - The Summit: camps/summit.md
  - Resources:
    - Contributing: resources/contributing.md

# Plugins
plugins:
  - search
  - glightbox
  - git-revision-date-localized:
      enable_creation_date: true

# Extra
extra:
  social:
    - icon: fontawesome/brands/github
      link: https://github.com/Azure-Samples/sherpa
    - icon: fontawesome/brands/microsoft
      link: https://azure.microsoft.com
  analytics:
    provider: google
    property: G-4X6V7HSB1J
    feedback:
      title: Was this page helpful?
      ratings:
        - icon: material/emoticon-happy-outline
          name: This page was helpful
          data: 1
          note: >-
            Thanks for your feedback!
        - icon: material/emoticon-sad-outline
          name: This page could be improved
          data: 0
          note: >-
            Thanks for your feedback! Help us improve by opening an issue.

extra_css:
  - stylesheets/extra.css