GITBOOK-35: Policy page improvements

SUMMARY.md

@@ -197,16 +197,16 @@
   * [Alerting](user/observability/alerting.md)
 * [Policy Based Management](user/policy-based-management/README.md)
   * [Policies](user/policy-based-management/policies/README.md)
-    * [Kubernetes](user/policy-based-management/policies/kubernetes/README.md)
-      * [Create a Kubernetes RBAC policy](user/policy-based-management/policies/kubernetes/kubernetes-rbac-policy.md)
-      * [Create a Kubernetes security policy](user/policy-based-management/policies/kubernetes/kubernetes-security-policy.md)
-      * [Create a Kubernetes setup policy](user/policy-based-management/policies/kubernetes/kubernetes-setup-policy.md)
-      * [Create a Kubernetes registry policy](user/policy-based-management/policies/kubernetes/kubernetes-registry-policy.md)
-    * [Docker](user/policy-based-management/policies/docker/README.md)
-      * [Create a Docker, Swarm or Podman RBAC policy](user/policy-based-management/policies/docker/rbac-policy.md)
-      * [Create a Docker, Swarm or Podman security policy](user/policy-based-management/policies/docker/security-policy.md)
-      * [Create a Docker, Swarm or Podman setup policy](user/policy-based-management/policies/docker/setup-policy.md)
-      * [Create a Docker, Swarm or Podman registry policy](user/policy-based-management/policies/docker/registry-policy.md)
+    * [Kubernetes Policies](user/policy-based-management/policies/kubernetes-policies/README.md)
+      * [Create a Kubernetes RBAC policy](user/policy-based-management/policies/kubernetes-policies/kubernetes-rbac-policy.md)
+      * [Create a Kubernetes security policy](user/policy-based-management/policies/kubernetes-policies/kubernetes-security-policy.md)
+      * [Create a Kubernetes setup policy](user/policy-based-management/policies/kubernetes-policies/kubernetes-setup-policy.md)
+      * [Create a Kubernetes registry policy](user/policy-based-management/policies/kubernetes-policies/kubernetes-registry-policy.md)
+    * [Docker Policies](user/policy-based-management/policies/docker-policies/README.md)
+      * [Create a Docker, Swarm or Podman RBAC policy](user/policy-based-management/policies/docker-policies/rbac-policy.md)
+      * [Create a Docker, Swarm or Podman security policy](user/policy-based-management/policies/docker-policies/security-policy.md)
+      * [Create a Docker, Swarm or Podman setup policy](user/policy-based-management/policies/docker-policies/setup-policy.md)
+      * [Create a Docker, Swarm or Podman registry policy](user/policy-based-management/policies/docker-policies/registry-policy.md)
 * [Account settings](user/account-settings.md)
 
 ## Administering Portainer <a href="#admin" id="admin"></a>

user/policy-based-management/policies/README.md

@@ -30,11 +30,17 @@ From the menu, under **Additional Functionality**, select **Policy Based Managem
 
 <figure><img src="../../../.gitbook/assets/2.38-Add-policy.gif" alt=""><figcaption></figcaption></figure>
 
-There multiple policy types available, depending on the environment type you are managing and the kind of access you want to enforce. You can use the search function or filter by environment type or policy category to narrow down the list.
+There are multiple policy types available, depending on the environment type you are managing and the kind of access you want to enforce. You can use the search function or filter by environment type or policy category to narrow down the list.
 
-After selecting a policy type, select **Continue** at the bottom of the page to open the configuration form. The fields shown will vary depending on the policy you are creating, and each form guides you through the required settings for that specific policy. Select a policy type below for more details on creating the policy.&#x20;
+After selecting a policy type, select **Continue** at the bottom of the page to open the configuration form. The fields shown will vary depending on the policy you are creating, and each form guides you through the required settings for that specific policy. Select an environment type below for more details on creating the policy.&#x20;
 
-<table data-column-title-hidden data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="image">Cover image</th></tr></thead><tbody><tr><td><h4>Kubernetes RBAC</h4></td><td><a href="kubernetes/kubernetes-rbac-policy.md">kubernetes-rbac-policy.md</a></td><td data-object-fit="fill"><a href="../../../.gitbook/assets/2.37.0-Kube-rbac-1.png">2.37.0-Kube-rbac-1.png</a></td></tr><tr><td><h4>Kubernetes Security</h4></td><td><a href="kubernetes/kubernetes-security-policy.md">kubernetes-security-policy.md</a></td><td data-object-fit="contain"><a href="../../../.gitbook/assets/2.37.0-Kube-security.png">2.37.0-Kube-security.png</a></td></tr><tr><td><h4>Kubernetes Setup</h4></td><td><a href="kubernetes/kubernetes-setup-policy.md">kubernetes-setup-policy.md</a></td><td data-object-fit="contain"><a href="../../../.gitbook/assets/2.37.0-Kube-setup-policy.png">2.37.0-Kube-setup-policy.png</a></td></tr><tr><td><h4>Kubernetes Registry</h4></td><td><a href="kubernetes/kubernetes-registry-policy.md">kubernetes-registry-policy.md</a></td><td data-object-fit="contain"><a href="../../../.gitbook/assets/2.37.0-Kube-Reg-policy.png">2.37.0-Kube-Reg-policy.png</a></td></tr><tr><td><h4>Docker / Swarm / Podman RBAC</h4></td><td><a href="docker/rbac-policy.md">rbac-policy.md</a></td><td data-object-fit="contain"><a href="../../../.gitbook/assets/2.37.0-RBAC-policy.png">2.37.0-RBAC-policy.png</a></td></tr><tr><td><h4>Docker / Swarm / Podman Security</h4></td><td><a href="docker/security-policy.md">security-policy.md</a></td><td data-object-fit="contain"><a href="../../../.gitbook/assets/2.37.0-Security-policy.png">2.37.0-Security-policy.png</a></td></tr><tr><td><h4>Docker / Swarm / Podman Setup</h4></td><td><a href="docker/setup-policy.md">setup-policy.md</a></td><td data-object-fit="contain"><a href="../../../.gitbook/assets/2.37.0-Setup-policy.png">2.37.0-Setup-policy.png</a></td></tr><tr><td><h4>Docker / Swarm / Podman Registry</h4></td><td><a href="docker/registry-policy.md">registry-policy.md</a></td><td data-object-fit="contain"><a href="../../../.gitbook/assets/Screenshot 2025-12-05 at 10.23.28 AM.png">Screenshot 2025-12-05 at 10.23.28 AM.png</a></td></tr></tbody></table>
+{% content-ref url="kubernetes-policies/" %}
+[kubernetes-policies](kubernetes-policies/)
+{% endcontent-ref %}
+
+{% content-ref url="docker-policies/" %}
+[docker-policies](docker-policies/)
+{% endcontent-ref %}
 
 ## View policy details
 
@@ -72,7 +78,7 @@ The attachment tab displays details about the environments attached to the polic
 
 ### Settings&#x20;
 
-The Settings tab shows the policy configuration. Settings vary by policy type. Details for each policy type are covered in the [Kubernetes policies](kubernetes/) and [Docker policies](docker/) sections of this documentation.
+The Settings tab shows the policy configuration. Settings vary by policy type. Details for each policy type are covered in the [Kubernetes policies](kubernetes-policies/) and [Docker policies](docker-policies/) sections of this documentation.
 
 ## Remove a policy
 

whats-new.md

@@ -20,6 +20,6 @@ You can read more about our release principles in our [lifecycle policy](start/l
 
 Since the initial release of [Policies](user/policy-based-management/policies/) as part of the Policy Based Management feature, improvements and new functionality have been added to simplify creating centralized policies across groups of environments. 
 
-Along with [numerous fixes and UI improvements](release-notes.md#release-2.38.0-sts), this release introduces policy templates that provide preconfigured policies, making policy creation possible in just a few clicks. Templates are currently available for [Kubernetes security ](user/policy-based-management/policies/kubernetes/kubernetes-security-policy.md)and [Docker security](user/policy-based-management/policies/docker/security-policy.md) policies, with more to come in future releases.
+Along with [numerous fixes and UI improvements](release-notes.md#release-2.38.0-sts), this release introduces policy templates that provide preconfigured policies, making policy creation possible in just a few clicks. Templates are currently available for [Kubernetes security ](user/policy-based-management/policies/kubernetes-policies/kubernetes-security-policy.md)and [Docker security](user/policy-based-management/policies/docker-policies/security-policy.md) policies, with more to come in future releases.
 
 <figure><img src=".gitbook/assets/2.38-whatsnew-policy-templates.png" alt=""><figcaption></figcaption></figure>