ACS/mkdocs.yml at dev · Agent-Control-Standard/ACS · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
site_name: Agent Control Standard
site_url: !ENV GITHUB_PAGES_URL
site_description: >-
  An industry standard for building trustworthy AI agents - instrumentable, traceable and inspectable
   to enable enterprise-wide adoption with confidence.

# Repository
repo_name: Agent-Control-Standard/ACS
repo_url: https://github.com/Agent-Control-Standard/ACS
edit_uri: edit/dev/docs/

# Copyright
copyright: Copyright &copy; 2025 ACS

docs_dir: docs

theme:
  name: material
  logo: assets/logo.png
  features:
    - search.suggest
    # edit this page for each doc page
    - content.action.edit
    # enable synchronized tabs
    - content.tabs.link
  palette:
    - media: "(prefers-color-scheme)"
      toggle:
        icon: material/link
        name: Switch to light mode
    - media: "(prefers-color-scheme: light)"
      scheme: default
      primary: indigo
      accent: indigo
      toggle:
        icon: material/toggle-switch
        name: Switch to dark mode
    - media: "(prefers-color-scheme: dark)"
      scheme: slate
      primary: black
      accent: indigo
      toggle:
        icon: material/toggle-switch-off
        name: Switch to system preference
  font:
    text: Roboto
    code: Roboto Mono
  favicon: assets/logo.png

plugins:
  - search

# Additional configuration
extra:
  analytics:
    provider: google
    property: !ENV GOOGLE_ANALYTICS_KEY
  social:
    - icon: /fontawesome/regular/envelope
      name: Send us an email
      link: mailto:acs@zenity.io

nav:
  - Trustworthy Agents: README.md
  - ACS: acs.md
  - Topics:
    - Core concepts: topics/core_concepts.md
    - ACS in Action: topics/ACS_in_action_example.md
  - Specification:
    - Instrument:
      - Overview: spec/instrument/README.md
      - Supported Hooks: spec/instrument/hooks.md
      - ACS specification: spec/instrument/specification.md
      - Instrument MCP: spec/instrument/extend_mcp.md
      - Instrument A2A: spec/instrument/a2a/extend_a2a.md
    - Trace:
      - Overview: spec/trace/README.md
      - Supported Events: spec/trace/events.md
      - Trace with OpenTelemetry: spec/trace/extend_opentelemetry.md
      - Trace with OCSF: spec/trace/extend_ocsf.md
      - OCSF Implementation Examples: spec/trace/OCSF/implementation_examples.md
    - Inspect:
      - Overview: spec/inspect/README.md
      - AgBOM with CycloneDX: spec/inspect/extend_cyclonedx.md
      - AgBOM with SPDX: spec/inspect/extend_spdx.md
      - AgBOM with SWID: spec/inspect/extend_swid.md
  - About: about.md

extra_css:
  - stylesheets/extra.css

markdown_extensions:
  # Emojis
  - attr_list
  - pymdownx.emoji:
      emoji_index: !!python/name:material.extensions.emoji.twemoji
      emoji_generator: !!python/name:material.extensions.emoji.to_svg
  # Syntax Highlighting
  - pymdownx.highlight:
      anchor_linenums: true
      line_spans: __span
      pygments_lang_class: true
  - pymdownx.inlinehilite
  - pymdownx.snippets
  - pymdownx.superfences
  # Callouts
  - admonition
  - pymdownx.details
  # Tabs
  - pymdownx.tabbed:
      alternate_style: true