*: update for oc/image-spec

WIP

Author: vbatts

manifest.md

@@ -29,26 +29,25 @@ A client will distinguish a manifest list from an image manifest based on the Co
 
 - **`schemaVersion`** *int*
 
-  This field specifies the image manifest schema version as an integer. This
-  schema uses the version `2`.
+  This field specifies the image manifest schema version as an integer.
+  This schema uses the version `0`.
 
 - **`mediaType`** *string*
 
-  The MIME type of the manifest list. This should be set to
-  `application/vnd.oci.image.manifest.list.v1+json`.
+  This REQUIRED property contains the MIME type of the referenced object.
+  This should be set to `application/vnd.oci.image.manifest.list.v1+json`.
 
 - **`manifests`** *array*
 
-  The manifests field contains a list of manifests for specific platforms.
+  This REQUIRED property contains a list of manifests for specific platforms.
+  While the property MUST be present, the size of the array MAY be zero.
 
-  Fields of a object in the manifests list are:
+  Fields of each object in the manifests list are:
 
   - **`mediaType`** *string*
 
-    The MIME type of the referenced object. This will generally be
-    `application/vnd.oci.image.manifest.v1+json`, but it could also
-    be `application/vnd.oci.image.manifest.v1+json` if the manifest
-    list references a legacy schema-1 manifest.
+    The MIME type of the referenced object.
+    This will generally be `application/vnd.oci.image.manifest.v1+json`.
 
   - **`size`** *int*
 
@@ -62,39 +61,39 @@ A client will distinguish a manifest list from an image manifest based on the Co
 
   - **`platform`** *object*
 
-    The platform object describes the platform which the image in the manifest runs on.
+    This REQUIRED property describes the platform which the image in the manifest runs on.
     A full list of valid operating system and architecture values are listed in the [Go language documentation for `$GOOS` and `$GOARCH`](https://golang.org/doc/install/source#environment)
 
     - **`architecture`** *string*
 
-        The architecture field specifies the CPU architecture, for example `amd64` or `ppc64le`.
+        This REQUIRED property specified the CPU architecture, for example `amd64` or `ppc64le`.
 
     - **`os`** *string*
 
-        The os field specifies the operating system, for example `linux` or `windows`.
+        This REQUIRED property specifies the operating system, for example `linux` or `windows`.
 
     - **`os.version`** *string*
 
-        The optional os.version field specifies the operating system version, for example `10.0.10586`.
+        This optional property specifies the operating system version, for example `10.0.10586`.
 
     - **`os.features`** *array*
 
-        The optional os.features field specifies an array of strings, each listing a required OS feature (for example on Windows `win32k`).
+        This OPTIONAL property specifies an array of strings, each specifying a mandatory OS feature (for example on Windows `win32k`).
 
     - **`variant`** *string*
 
-        The optional variant field specifies a variant of the CPU, for example `armv6l` to specify a particular CPU variant of the ARM CPU.
+        This OPTIONAL property specifies the variant of the CPU, for example `armv6l` to specify a particular CPU variant of the ARM CPU.
 
     - **`features`** *array*
 
-        The optional features field specifies an array of strings, each listing a required CPU feature (for example `sse4` or `aes`).
+        This OPTIONAL property specifies an array of strings, each specifying a mandatory CPU feature (for example `sse4` or `aes`).
 
 ## Example Manifest List
 
 *Example showing a simple manifest list pointing to image manifests for two platforms:*
 ```json
 {
-  "schemaVersion": 2,
+  "schemaVersion": 0,
   "mediaType": "application/vnd.oci.image.manifest.list.v1+json",
   "manifests": [
     {
@@ -125,14 +124,13 @@ A client will distinguish a manifest list from an image manifest based on the Co
 # Image Manifest
 
 The image manifest provides a configuration and a set of layers for a container image.
-It's the direct replacement for the schema-1 manifest.
 
 ## *Image Manifest* Field Descriptions
 
 - **`schemaVersion`** *int*
 
   This field specifies the image manifest schema version as an integer.
-  This schema uses version `2`.
+  This schema uses version `0`.
 
 - **`mediaType`** *string*
 
@@ -194,8 +192,8 @@ It's the direct replacement for the schema-1 manifest.
 *Example showing an image manifest:*
 ```json
 {
-    "schemaVersion": 2,
-    "mediaType": "application/vnd.oci.image.manifest.v2+json",
+    "schemaVersion": 0,
+    "mediaType": "application/vnd.oci.image.manifest.v1+json",
     "config": {
         "mediaType": "application/vnd.oci.image.serialization.v1+json",
         "size": 7023,