Skip to content

Commit 89f0206

Browse files
docs: add policy-as-code tutorial chapters 6-7 (testing & versioning) (#916)
* docs: add MIT license headers to chapters 1-4 files Normalize license headers across all tutorial chapters. Chapters 5-7 already had them; this adds them to chapters 1-4 markdown and YAML example files for consistency. * docs: add policy-as-code tutorial chapter 6 (policy testing) Covers structural validation with Pydantic, declarative YAML test scenarios, cross-policy test matrices, and regression detection. Includes runnable Python example and test fixtures. * docs: add policy-as-code tutorial chapter 7 (policy versioning) Covers side-by-side version comparison, structural diffing, behavioral regression detection, and deploy gates. Updates README to link chapters 6-7 and fixes chapter 5 nav link.
1 parent fdf9f0e commit 89f0206

21 files changed

+1723
-5
lines changed

docs/tutorials/policy-as-code/01-your-first-policy.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,6 @@
1+
<!-- Copyright (c) Microsoft Corporation. -->
2+
<!-- Licensed under the MIT License. -->
3+
14
# Chapter 1: Your First Policy
25

36
In this chapter you will write a YAML policy file that blocks dangerous agent

docs/tutorials/policy-as-code/02-capability-scoping.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,6 @@
1+
<!-- Copyright (c) Microsoft Corporation. -->
2+
<!-- Licensed under the MIT License. -->
3+
14
# Chapter 2: Capability Scoping
25

36
In Chapter 1 you created a single policy that applies to every agent. In

docs/tutorials/policy-as-code/03-rate-limiting.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,6 @@
1+
<!-- Copyright (c) Microsoft Corporation. -->
2+
<!-- Licensed under the MIT License. -->
3+
14
# Chapter 3: Rate Limiting
25

36
An agent with the right permissions can still cause problems if it runs out of

docs/tutorials/policy-as-code/04-conditional-policies.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,6 @@
1+
<!-- Copyright (c) Microsoft Corporation. -->
2+
<!-- Licensed under the MIT License. -->
3+
14
# Chapter 4: Conditional Policies
25

36
In Chapters 1-3 each policy stood on its own — one file, one evaluator, one

docs/tutorials/policy-as-code/05-approval-workflows.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -463,5 +463,5 @@ every tool gets the right decision in every environment. That is policy
463463
testing.
464464

465465
**Previous:** [Chapter 4 — Conditional Policies](04-conditional-policies.md)
466-
**Next:** Chapter 6 — Policy Testing (coming soon) — verify that every
466+
**Next:** [Chapter 6 — Policy Testing](06-policy-testing.md) — verify that every
467467
policy rule works correctly, automatically.

0 commit comments

Comments
 (0)