docs: add JSON Schema for policy (#3353)

cmd/gen-jsonschema/main.go

@@ -9,6 +9,7 @@ import (
 
 	"github.com/aquaproj/aqua/v2/pkg/config/aqua"
 	"github.com/aquaproj/aqua/v2/pkg/config/registry"
+	"github.com/aquaproj/aqua/v2/pkg/policy"
 	"github.com/invopop/jsonschema"
 )
 
@@ -25,6 +26,9 @@ func core() error {
 	if err := gen(&registry.Config{}, "json-schema/registry.json"); err != nil {
 		return err
 	}
+	if err := gen(&policy.ConfigYAML{}, "json-schema/policy.json"); err != nil {
+		return err
+	}
 	return nil
 }
 

json-schema/policy.json

@@ -0,0 +1,75 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/aquaproj/aqua/v2/pkg/policy/config-yaml",
+  "$ref": "#/$defs/ConfigYAML",
+  "$defs": {
+    "ConfigYAML": {
+      "properties": {
+        "registries": {
+          "items": {
+            "$ref": "#/$defs/Registry"
+          },
+          "type": "array"
+        },
+        "packages": {
+          "items": {
+            "$ref": "#/$defs/Package"
+          },
+          "type": "array"
+        }
+      },
+      "additionalProperties": false,
+      "type": "object",
+      "required": [
+        "registries"
+      ]
+    },
+    "Package": {
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "version": {
+          "type": "string"
+        },
+        "registry": {
+          "type": "string"
+        }
+      },
+      "additionalProperties": false,
+      "type": "object",
+      "required": [
+        "name"
+      ]
+    },
+    "Registry": {
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "type": {
+          "type": "string",
+          "enum": [
+            "standard",
+            "local",
+            "github_content"
+          ]
+        },
+        "repo_owner": {
+          "type": "string"
+        },
+        "repo_name": {
+          "type": "string"
+        },
+        "ref": {
+          "type": "string"
+        },
+        "path": {
+          "type": "string"
+        }
+      },
+      "additionalProperties": false,
+      "type": "object"
+    }
+  }
+}