diff --git a/README.md b/README.md
index 8e3b82914b..55a2381860 100644
--- a/README.md
+++ b/README.md
@@ -123,10 +123,10 @@ Refer to a list of curated of ***[sample policies](/samples/README.md)*** that c
* [Getting Started](documentation/installation.md)
* [Writing Policies](documentation/writing-policies.md)
- * [Mutate](documentation/writing-policies-mutate.md)
- * [Validate](documentation/writing-policies-validate.md)
- * [Generate](documentation/writing-policies-generate.md)
- * [Variables](documentation/writing-policies-variables.md)
+ * [Mutate Resources](documentation/writing-policies-mutate.md)
+ * [Validate Resources](documentation/writing-policies-validate.md)
+ * [Generate Resources](documentation/writing-policies-generate.md)
+ * [Variable Substitution](documentation/writing-policies-variables.md)
* [Preconditions](documentation/writing-policies-preconditions.md)
* [Auto-Generation of Pod Controller Policies](documentation/writing-policies-autogen.md)
* [Background Processing](documentation/writing-policies-background.md)
diff --git a/documentation/writing-policies-generate.md b/documentation/writing-policies-generate.md
index 837a939546..6780e96840 100644
--- a/documentation/writing-policies-generate.md
+++ b/documentation/writing-policies-generate.md
@@ -1,6 +1,6 @@
-*[documentation](/README.md#documentation) / [Writing Policies](/documentation/writing-policies.md) / Generate*
+*[documentation](/README.md#documentation) / [Writing Policies](/documentation/writing-policies.md) / Generate Resources*
-# Generate Configurations
+# Generate Resources
```generate``` is used to create additional resources when a resource is created. This is useful to create supporting resources, such as role bindings for a new namespace.
diff --git a/documentation/writing-policies-mutate.md b/documentation/writing-policies-mutate.md
index a2eaf48704..b9a91cb81b 100644
--- a/documentation/writing-policies-mutate.md
+++ b/documentation/writing-policies-mutate.md
@@ -1,6 +1,6 @@
-*[documentation](/README.md#documentation) / [Writing Policies](/documentation/writing-policies.md) / Mutate*
+*[documentation](/README.md#documentation) / [Writing Policies](/documentation/writing-policies.md) / Mutate Resources*
-# Mutate Configurations
+# Mutate Resources
The ```mutate``` rule can be used to add, replace, or delete elements in matching resources. A mutate rule can be written as a JSON Patch or as an overlay.
diff --git a/documentation/writing-policies-validate.md b/documentation/writing-policies-validate.md
index 4a98b21d29..b8f09d5128 100644
--- a/documentation/writing-policies-validate.md
+++ b/documentation/writing-policies-validate.md
@@ -1,7 +1,7 @@
-*[documentation](/README.md#documentation) / [Writing Policies](/documentation/writing-policies.md) / Validate*
+*[documentation](/README.md#documentation) / [Writing Policies](/documentation/writing-policies.md) / Validate Resources*
-# Validate Configurations
+# Validate Resources
A validation rule is expressed as an overlay pattern that expresses the desired configuration. Resource configurations must match fields and expressions defined in the pattern to pass the validation rule. The following rules are followed when processing the overlay pattern:
@@ -191,4 +191,4 @@ Additional examples are available in [samples](/samples/README.md)
The `validationFailureAction` attribute controls processing behaviors when the resource is not compliant with the policy. If the value is set to `enforce` resource creation or updates are blocked when the resource does not comply, and when the value is set to `audit` a policy violation is reported but the resource creation or update is allowed.
---
-*Read Next >> [Generate](/documentation/writing-policies-mutate.md)*
+*Read Next >> [Generate](/documentation/writing-policies-generate.md)*