docs: Update Flag Manifest description and move important fields to t…

…he top of the file.

Signed-off-by: Florin-Mihai Anghel <[email protected]>

docs/schema/v0/flag_manifest.json

@@ -1,5 +1,22 @@
 {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "title": "Flag Manifest",
+    "description": "Describes a configuration of OpenFeature flags, including info such as their types and default values.",
+    "type": "object",
+    "properties": {
+        "flags": {
+            "description": "Object containing the flags in the config",
+            "type": "object",
+            "patternProperties": {
+                "^.{1,}$": {
+                    "description": "The definition of one flag",
+                    "$ref": "#/$defs/flag"
+                }
+            },
+            "additionalProperties": false
+        }
+    },
+    "required": ["flags"],
     "$defs": {
         "flag": {
             "oneOf": [
@@ -101,22 +118,5 @@
             },
             "additionalProperties": false
         }    
-    },
-    "title": "Flag Manifest",
-    "description": "Manifest meant to describe the flags of one flag configuration",
-    "type": "object",
-    "properties": {
-        "flags": {
-            "description": "Object containing the flags in the config",
-            "type": "object",
-            "patternProperties": {
-                "^.{1,}$": {
-                    "description": "The definition of one flag",
-                    "$ref": "#/$defs/flag"
-                }
-            },
-            "additionalProperties": false
-        }
-    },
-    "required": ["flags"]
+    }
 }