feat: add policy schema display

app/_layouts/default.html

@@ -93,6 +93,8 @@
     </div>
 
     <script async defer src="https://buttons.github.io/buttons.js"></script>
+    <script defer src="https://brianwendt.github.io/json-schema-md-doc/lib/JSONSchemaMarkdown.js"></script>
+    <script defer src="https://cdnjs.cloudflare.com/ajax/libs/showdown/1.9.0/showdown.min.js"></script>
     <script type="text/javascript" src="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.js"></script>
   </body>
 </html>

app/_src/policies/meshaccesslog.md

@@ -519,3 +519,7 @@ To target other non-mesh traffic, i.e. [passthrough traffic](/docs/{{ page.versi
 ## Select a built-in gateway
 
 You can select a built-in gateway using the `kuma.io/service` value. A current limitation is that traffic routed from a gateway to a service is logged by that gateway as having destination `"*"`.
+
+## All policy options
+
+{% policy_schema MeshAccessLog %}

app/_src/policies/meshcircuitbreaker.md

@@ -579,3 +579,7 @@ spec:
 We will apply the configuration with `kumactl apply -f [..]` or via the [HTTP API](/docs/{{ page.version }}/reference/http-api).
 {% endtab %}
 {% endtabs %}
+
+## All policy options
+
+{% policy_schema MeshCircuitBreaker %}

app/_src/policies/meshfaultinjection.md

@@ -261,3 +261,7 @@ Apply the configuration with `kumactl apply -f [..]` or with the [HTTP API](../.
 
 {% endtab %}
 {% endtabs %}
+
+## All policy options
+
+{% policy_schema MeshFaultInjection %}

app/_src/policies/meshhealthcheck.md

@@ -294,3 +294,7 @@ HTTP health checks are executed using HTTP2
 - **`serviceName`** - (optional) - service name parameter which will be sent to gRPC service
 - **`authority`** - (optional) - value of the :authority header in the gRPC health check request,
   by default name of the cluster this health check is associated with
+
+## All policy options
+
+{% policy_schema MeshHealthCheck %}

app/_src/policies/meshhttproute.md

@@ -321,3 +321,7 @@ rules:
         method: POST
     default: merge(CONF_2, CONF_4) # because 'key-2' == 'key-4'
 ```
+
+## All policy options
+
+{% policy_schema MeshHTTPRoute %}

app/_src/policies/meshloadbalancingstrategy.md

@@ -236,4 +236,8 @@ spec:
 Apply the configuration with `kumactl apply -f [..]` or with the [HTTP API](../../reference/http-api).
 
 {% endtab %}
-{% endtabs %}
+{% endtabs %}
+
+## All policy options
+
+{% policy_schema MeshLoadBalancingStrategy %}

app/_src/policies/meshproxypatch.md

@@ -1580,3 +1580,6 @@ spec:
 {% endtab %}
 {% endtabs %}
 
+## All policy options
+
+{% policy_schema MeshProxyPatch %}

app/_src/policies/meshratelimit.md

@@ -183,3 +183,7 @@ spec:
 We will apply the configuration with `kumactl apply -f [..]` or via the [HTTP API](/docs/{{ page.version }}/reference/http-api).
 {% endtab %}
 {% endtabs %}
+
+## All policy options
+
+{% policy_schema MeshRateLimit %}

app/_src/policies/meshretry.md

@@ -325,3 +325,7 @@ Apply the configuration with `kumactl apply -f [..]` or with the [HTTP API](../.
 
 {% endtab %}
 {% endtabs %}
+
+## All policy options
+
+{% policy_schema MeshRetry %}

app/_src/policies/meshtimeout.md

@@ -332,4 +332,8 @@ We will apply the configuration with `kumactl apply -f [..]` or via the [HTTP AP
 
 {% if_version eq:2.1.x %}
 If you don't specify `from` or `to` section defaults from [Timeout policy](../timeout) will be used. This is [known bug](https://github.com/kumahq/kuma/issues/5850) and will be fixed in the next version.
-{% endif_version %}
+{% endif_version %}
+
+## All policy options
+
+{% policy_schema MeshTimeout %}

app/_src/policies/meshtrace.md

@@ -554,3 +554,7 @@ spec:
 ```
 {% endtab %}
 {% endtabs %}
+
+## All policy options
+
+{% policy_schema MeshTrace %}

app/_src/policies/meshtrafficpermission.md

@@ -277,3 +277,7 @@ Order of rules inside the `from` array matters.
 Request from the proxy that has both `kuma.io/zone: east` and `env: dev` will be denied. 
 This is because the rule with `Deny` is later in the `from` array than any `Allow` rules.
 {% endtip %}
+
+## All policy options
+
+{% policy_schema MeshTrafficPermission %}

app/docs/2.0.x/generated/DoNothingPolicy.json

@@ -0,0 +1,153 @@
+{
+  "properties": {
+    "type": {
+      "description": "",
+      "type": "string",
+      "enum": [
+        "DoNothingPolicy"
+      ]
+    },
+    "mesh": {
+      "description": "Mesh is the name of the Kuma mesh this resource belongs to. It may be omitted for cluster-scoped resources.",
+      "type": "string"
+    },
+    "name": {
+      "description": "Name of the Kuma resource",
+      "type": "string"
+    },
+    "from": {
+      "description": "From list makes a match between clients and corresponding configurations",
+      "items": {
+        "properties": {
+          "default": {
+            "description": "Default is a configuration specific to the group of clients referenced in 'targetRef'",
+            "properties": {
+              "enableDoNothing": {
+                "description": "User defined fields Set true in case of doing nothing",
+                "type": "boolean"
+              }
+            },
+            "type": "object"
+          },
+          "targetRef": {
+            "description": "TargetRef is a reference to the resource that represents a group of clients.",
+            "properties": {
+              "kind": {
+                "description": "Kind of the referenced resource",
+                "enum": [
+                  "Mesh",
+                  "MeshSubset",
+                  "MeshService",
+                  "MeshServiceSubset",
+                  "MeshGatewayRoute"
+                ],
+                "type": "string"
+              },
+              "mesh": {
+                "description": "Mesh is reserved for future use to identify cross mesh resources.",
+                "type": "string"
+              },
+              "name": {
+                "description": "Name of the referenced resource. Can only be used with kinds: `MeshService`, `MeshServiceSubset` and `MeshGatewayRoute`",
+                "type": "string"
+              },
+              "tags": {
+                "additionalProperties": {
+                  "type": "string"
+                },
+                "description": "Tags used to select a subset of proxies by tags. Can only be used with kinds `MeshSubset` and `MeshServiceSubset`",
+                "type": "object"
+              }
+            },
+            "type": "object"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "targetRef": {
+      "description": "TargetRef is a reference to the resource the policy takes an effect on. The resource could be either a real store object or virtual resource defined inplace.",
+      "properties": {
+        "kind": {
+          "description": "Kind of the referenced resource",
+          "enum": [
+            "Mesh",
+            "MeshSubset",
+            "MeshService",
+            "MeshServiceSubset",
+            "MeshGatewayRoute"
+          ],
+          "type": "string"
+        },
+        "mesh": {
+          "description": "Mesh is reserved for future use to identify cross mesh resources.",
+          "type": "string"
+        },
+        "name": {
+          "description": "Name of the referenced resource. Can only be used with kinds: `MeshService`, `MeshServiceSubset` and `MeshGatewayRoute`",
+          "type": "string"
+        },
+        "tags": {
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "Tags used to select a subset of proxies by tags. Can only be used with kinds `MeshSubset` and `MeshServiceSubset`",
+          "type": "object"
+        }
+      },
+      "type": "object"
+    },
+    "to": {
+      "description": "To list makes a match between the consumed services and corresponding configurations",
+      "items": {
+        "properties": {
+          "default": {
+            "description": "Default is a configuration specific to the group of destinations referenced in 'targetRef'",
+            "properties": {
+              "enableDoNothing": {
+                "description": "User defined fields Set true in case of doing nothing",
+                "type": "boolean"
+              }
+            },
+            "type": "object"
+          },
+          "targetRef": {
+            "description": "TargetRef is a reference to the resource that represents a group of destinations.",
+            "properties": {
+              "kind": {
+                "description": "Kind of the referenced resource",
+                "enum": [
+                  "Mesh",
+                  "MeshSubset",
+                  "MeshService",
+                  "MeshServiceSubset",
+                  "MeshGatewayRoute"
+                ],
+                "type": "string"
+              },
+              "mesh": {
+                "description": "Mesh is reserved for future use to identify cross mesh resources.",
+                "type": "string"
+              },
+              "name": {
+                "description": "Name of the referenced resource. Can only be used with kinds: `MeshService`, `MeshServiceSubset` and `MeshGatewayRoute`",
+                "type": "string"
+              },
+              "tags": {
+                "additionalProperties": {
+                  "type": "string"
+                },
+                "description": "Tags used to select a subset of proxies by tags. Can only be used with kinds `MeshSubset` and `MeshServiceSubset`",
+                "type": "object"
+              }
+            },
+            "type": "object"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    }
+  }
+}