From aa2ffb3f49f2318d1bba345b6ca20f1577730cca Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
 <41898282+github-actions[bot]@users.noreply.github.com>
Date: Mon, 10 Aug 2026 00:49:53 +0000
Subject: [PATCH] docs: add permissions-required to front-matter example block

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 docs/front-matter.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/front-matter.md b/docs/front-matter.md
index 2f4c1368..a7b869e6 100644
--- a/docs/front-matter.md
+++ b/docs/front-matter.md
@@ -268,6 +268,10 @@ permissions:                   # optional ADO access token configuration (see do
                                  # Default: executor uses $(System.AccessToken).
                                  # Set this only for cross-org writes or
                                  # named-identity attribution.
+# permissions-required:         # abstract capability requirements for imported components
+#   read: true                  # only valid on components; unioned across imports and consumer;
+#   write: true                 # consumer must satisfy `read: true` with a concrete `permissions.read`
+                                 # connection (see docs/imports.md#permissions-required)
 supply-chain:                  # optional internal supply-chain mirror (see docs/supply-chain.md)
   feed:                          # mirror binaries (compiler, AWF, ado-script) from an ADO Artifacts feed
     name: my-project/my-feed     # feed name or project/feed; scalar `feed: my-feed` shorthand also works