Add links to schema files in ReachabilityMetadata.md

Author: dnestoro

docs/reference-manual/native-image/ReachabilityMetadata.md

@@ -61,7 +61,7 @@ Computing metadata in code can be achieved in two ways:
             return aClass;
         }
     }
-  ```
+    ```
 
   When metadata is computed in code, the dynamically accessed elements will be included into the native executable's heap only if that part of the heap is reachable through an enclosing method (for example, `ReflectiveAccess#fetchFoo`) or a static field (for example, `InitializedAtBuildTime.aClass`).
 
@@ -89,6 +89,8 @@ A condition is specified in the following way:
 An entry with a `typeReachable` condition is considered only when the fully-qualified class is reachable.
 Currently, we support only `typeReachable` as a condition.
 
+**Examples of the config files can be found in [GraalVM Reachability Metadata repository](https://github.com/oracle/graalvm-reachability-metadata)**
+
 ## Metadata Types
 
 Native Image accepts the following types of reachability metadata:
@@ -144,53 +146,8 @@ Integer.class.getMethod("parseInt", params2);
 
 ### Specifying Reflection Metadata in JSON
 
-Reflection metadata can be specified in the `reflect-config.json` file.
-The JSON file is an array of reflection entries:
-```json
-[
-    {
-        "condition": {
-            "typeReachable": "<condition-class>"
-        },
-        "name": "<class>",
-        "methods": [
-            {"name": "<methodName>", "parameterTypes": ["<param-one-type>"]}
-        ],
-        "queriedMethods": [
-            {"name": "<methodName>", "parameterTypes": ["<param-one-type>"]}
-        ],
-        "fields": [
-            {"name": "<fieldName>"}
-        ],
-        "allDeclaredMethods": true,
-        "allDeclaredFields": true,
-        "allDeclaredConstructors": true,
-        "allPublicMethods": true,
-        "allPublicFields": true,
-        "allPublicConstructors": true,
-        "queryAllDeclaredMethods": true,
-        "queryAllDeclaredConstructors": true,
-        "queryAllPublicMethods": true,
-        "queryAllPublicConstructors": true,
-        "unsafeAllocated": true
-    }
-]
-```
-
-The fields in a reflection entry have the following meaning:
- - `condition`: See [Conditional Metadata Entries](#specifying-metadata-with-json)
- - `name`: Name of the class that will be reflectively looked up. This property is mandatory.
- - `methods`: List class methods that can be looked up and executed reflectively.
- Each method is described by its name and a list of parameter types.
- The parameter types are fully qualified Java class names.
- - `queriedMethods`: List of class methods that can only be looked up.
- The description of each method is identical to the `methods` list.
- - `fields`: List of class fields that can be looked up, read, or modified.
- - `all<access>(Methods/Fields/Constructors)`: Registers all methods/fields/constructors for lookup. Methods and constructors can also be invoked.
- `<access>` refers to different ways of querying these members in Java and can be either `Declared` or `Public`.
- For more information, see `java.lang.Class.getDeclaredMethods()` and `java.lang.Class.getPublicMethods()`.
- - `queryAll<access>(Methods/Constructors)`: Registers all methods/constructors for lookup only.
- - `unsafeAllocated`: Allows objects of this class to be allocated using `Unsafe.allocateInstance`.
+Reflection metadata can be specified in the `reflect-config.json` file. 
+Detailed explanation of the config file can be found in the corresponding [json schema](https://github.com/oracle/graal/blob/master/docs/reference-manual/native-image/assets/reflect-config-schema-v1.0.0.json).
 
 ## Java Native Interface
 
@@ -214,7 +171,7 @@ It is not possible to specify JNI metadata in code.
 
 ### JNI Metadata in JSON
 Metadata for JNI is provided in `jni-config.json` files.
-The JSON schema of JNI metadata is identical to the [Reflection metadata schema](#specifying-reflection-metadata-in-json).
+Detailed explanation of the config file can be found in the corresponding [json schema](https://github.com/oracle/graal/blob/master/docs/reference-manual/native-image/assets/jni-config-schema-v1.0.0.json).
 
 ## Resources and Resource Bundles
 Java is capable of accessing any resource on the application class path, or the module path for which the requesting code has permission to access.
@@ -242,41 +199,7 @@ class Example {
 
 ### Resource Metadata in JSON
 Metadata for resources is provided in `resource-config.json` files.
-```json
-{
-  "resources": {
-    "includes": [
-      {
-        "condition": {
-          "typeReachable": "<condition-class>" 
-        },
-        "pattern": ".*\\.txt"
-      }
-    ],
-    "excludes": [
-      {
-        "condition": {
-          "typeReachable": "<condition-class>"
-        },
-        "pattern": ".*\\.txt"
-      }
-    ]
-  },
-  "bundles": [
-    {
-      "condition": {
-        "typeReachable": "<condition-class>"
-      },
-      "name": "fully.qualified.bundle.name",
-      "locales": ["en", "de", "sk"]
-    }
-  ]
-}
-```
-
-Native Image will iterate over all resources and match their relative paths against the Java regex specified in `includes`.
-If the path matches the regex, the resource is included.
-The `excludes` statement instructs `native-image` to omit certain included resources that match the given `pattern`.
+Detailed explanation of the config file can be found in the corresponding [json schema](https://github.com/oracle/graal/blob/master/docs/reference-manual/native-image/assets/resource-config-schema-v1.0.0.json).
 
 ## Dynamic Proxy
 
@@ -316,20 +239,8 @@ The following methods are evaluated at build time when called with constant argu
  - `java.lang.reflect.Proxy.newProxyInstance`
 
 ### Dynamic Proxy Metadata in JSON
-Metadata for dynamic proxies is provided in `proxy-config.json` files.
-```json
-[
-  {
-    "condition": {
-      "typeReachable": "<condition-class>"
-    },
-    "interfaces": [
-      "IA",
-      "IB"
-    ]
-  }
-]
-```
+Metadata for resources is provided in `proxy-config.json` files.
+Detailed explanation of the config file can be found in the corresponding [json schema](https://github.com/oracle/graal/blob/master/docs/reference-manual/native-image/assets/proxy-config-schema-v1.0.0.json).
 
 ## Serialization
 Java can serialize any class that implements the `Serializable` interface.
@@ -367,41 +278,7 @@ Proxy classes can only be registered for serialization via the JSON files.
 
 ### Serialization Metadata in JSON
 Metadata for serialization is provided in `serialization-config.json` files.
-```json
-{
-  "types": [
-    {
-      "condition": {
-        "typeReachable": "<condition-class>"
-      },
-      "name": "<fully-qualified-class-name>",
-      "customTargetConstructorClass": "<custom-target-constructor-class>"
-    }
-  ],
-  "lambdaCapturingTypes": [
-    {
-      "condition": {
-        "typeReachable": "<condition-class>"
-      },
-      "name": "<fully-qualified-class-name>"
-    }
-  ],
- "proxies": [
-   {
-     "condition": {
-       "typeReachable": "<condition-class>"
-     },
-     "interfaces": ["<fully-qualified-interface-name-1>", "<fully-qualified-interface-name-n>"]
-   }
- ]
-}
-```
-
-Each entry in `types` enables serializing and deserializing objects of the class given by `name`.
-
-Each entry in `lambdaCapturingTypes` enables lambda serialization: all lambdas declared in the methods of the class given by `name` can be serialized and deserialized.
-
-Each entry in `proxies` enables the [Proxy](https://docs.oracle.com/javase/8/docs/technotes/guides/reflection/proxy.html) serialization by providing an interface list that a proxy implements.
+Detailed explanation of the config file can be found in the corresponding [json schema](https://github.com/oracle/graal/blob/master/docs/reference-manual/native-image/assets/serialization-config-schema-v1.0.0.json).
 
 ## Predefined Classes
 
@@ -419,21 +296,7 @@ It is not possible to specify predefined classes in code.
 
 ### Predefined Classes Metadata in JSON
 Metadata for predefined classes is provided in `predefined-classes-config.json` files.
-```json
-[
-  {
-    "type": "agent-extracted",
-    "classes": [
-      {
-        "hash": "<class-bytecodes-hash>",
-        "nameInfo": "<class-name"
-      }
-    ]
-  }
-]
-```
-
-The JSON schema is accompanied by the `agent-extracted-predefined-classes` directory that contains the bytecode of the listed classes.
+Detailed explanation of the config file can be found in the corresponding [json schema](https://github.com/oracle/graal/blob/master/docs/reference-manual/native-image/assets/predefined-classes-config-schema-v1.0.0.json).
 
 ### Further Reading
 

docs/reference-manual/native-image/assets/jni-config-schema-v1.0.0.json

@@ -1,5 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2019-09/schema",
+  "$id": "https://github.com/oracle/graal/blob/master/docs/reference-manual/native-image/assets/jni-config-schema-v1.0.0.json",
   "default": [],
   "items": {
     "properties": {

docs/reference-manual/native-image/assets/predefined-classes-config-schema-v1.0.0.json

@@ -1,5 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2019-09/schema",
+  "$id": "https://github.com/oracle/graal/blob/master/docs/reference-manual/native-image/assets/predefined-classes-config-schema-v1.0.0.json",
   "default": [
     {
       "type": "agent-extracted",

docs/reference-manual/native-image/assets/proxy-config-schema-v1.0.0.json

@@ -1,5 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2019-09/schema",
+  "$id": "https://github.com/oracle/graal/blob/master/docs/reference-manual/native-image/assets/proxy-config-schema-v1.0.0.json",
   "default": [],
   "items": {
     "properties": {

docs/reference-manual/native-image/assets/reflect-config-schema-v1.0.0.json

@@ -1,5 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2019-09/schema",
+  "$id": "https://github.com/oracle/graal/blob/master/docs/reference-manual/native-image/assets/reflect-config-schema-v1.0.0.json",
   "default": [],
   "items": {
     "properties": {
@@ -86,7 +87,7 @@
           "type": "object"
         },
         "type": "array",
-        "title": "List of fields that should be registered for the class declared in <name>"
+        "title": "List of class fields that can be looked up, read, or modified for the class declared in <name>"
       },
       "allDeclaredMethods": {
         "default": false,

docs/reference-manual/native-image/assets/resource-config-schema-v1.0.0.json

@@ -1,5 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2019-09/schema",
+  "$id": "https://github.com/oracle/graal/blob/master/docs/reference-manual/native-image/assets/resource-config-schema-v1.0.0.json",
   "default": {
     "resources": {},
     "bundles": []
@@ -103,5 +104,6 @@
     "resources"
   ],
   "type": "object",
-  "title": "JSON schema for the resource-config that GraalVM Native Image uses"
+  "title": "JSON schema for the resource-config that GraalVM Native Image uses",
+  "description": "Native Image will iterate over all resources and match their relative paths against the Java regex specified in <includes>.If the path matches the regex, the resource is included. The <excludes> statement instructs <native-image> to omit certain included resources that match the given <pattern>"
 }

docs/reference-manual/native-image/assets/serialization-config-schema-v1.0.0.json

@@ -1,5 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2019-09/schema",
+  "$id": "https://github.com/oracle/graal/blob/master/docs/reference-manual/native-image/assets/serialization-config-schema-v1.0.0.json",
   "default": {
     "types": [],
     "lambdaCapturingTypes": [],
@@ -33,7 +34,7 @@
         },
         "type": "object"
       },
-      "title": "List of classes that should be serialized",
+      "title": "Each entry in <types> enables serializing and deserializing objects of the class given by <name>",
       "type": "array"
     },
     "lambdaCapturingTypes": {
@@ -59,7 +60,7 @@
         },
         "type": "object"
       },
-      "title": "List of classes that capture lambdas that should be serialized",
+      "title": "Each entry in <lambdaCapturingTypes> enables lambda serialization. All lambdas declared in the methods of the class given by <name> can be serialized and deserialized.",
       "type": "array"
     },
     "proxies": {
@@ -93,7 +94,7 @@
         "type": "object",
         "title": "Proxy that should be registered for serialization"
       },
-      "title": "List of proxies that should be serialized",
+      "title": "Each entry in <proxies> enables the proxy serialization by providing an interface list that a proxy implements.",
       "type": "array"
     }
   },