Update distribution docs

Signed-off-by: Aviral Takkar <[email protected]>

Author: aviral26

docs/distribution/README.md

@@ -303,19 +303,22 @@ The storage layout is represented as:
                             └── link
 ```
 
-Push a signature artifact and an OCI index that contains a config property referencing the signature:
+Push a signature as blob and an OCI Artifact that contains a blobs property referencing the signature:
 
-- signature index digest: `sha256:222ibbf80b44ce6be8234e6ff90a1ac34acbeb826903b02cfa0da11c82cb222i`
-- index json:
+- artifact digest: `sha256:222ibbf80b44ce6be8234e6ff90a1ac34acbeb826903b02cfa0da11c82cb222i`
+- artifact json:
     ```json
     {
         "schemaVersion": 2,
-        "mediaType": "application/vnd.oci.image.index.v2+json",
-        "config": {
-            "mediaType": "application/vnd.cncf.notary.config.v2+jwt",
+        "mediaType": "application/vnd.oci.artifact.manifest.v1+json",
+        "artifactType": "application/vnd.cncf.notary.v2",
+        "blobs": [
+          {
+            "mediaType": "application/vnd.cncf.notary.signature.v2+jwt",
             "digest": "sha256:222cb130c152895905abe66279dd9feaa68091ba55619f5b900f2ebed38b222c",
-            "size": 1906
-        },
+            "size": 2338
+          }
+        ],
         "manifests": [
             {
               "mediaType": "application/vnd.oci.image.manifest.v1+json",
@@ -330,9 +333,9 @@ Push a signature artifact and an OCI index that contains a config property refer
     }
     ```
 
-Consistent with the current distribution implementation, on `PUT`, the index appears as a manifest revision.
+Consistent with the current distribution implementation, on `PUT`, the artifact appears as a manifest revision.
 
-The Notary v2 prototype adds referrer metadata for the **wabbit-networks** signature:
+The prototype adds referrer metadata for the **wabbit-networks** signature:
 
 ```
 <root>
@@ -345,7 +348,7 @@ The Notary v2 prototype adds referrer metadata for the **wabbit-networks** signa
                         ├── 111ma2d22ae5ef400769fa51c84717264cd1520ac8d93dc071374c1be49a111m
                         │   ├── link
                         │   └── ref
-                        │       └── application/vnd.cncf.notary.config.v2+jwt
+                        │       └── digest(application/vnd.cncf.notary.v2)
                         │           └── sha256
                         │               └── 222cb130c152895905abe66279dd9feaa68091ba55619f5b900f2ebed38b222c
                         │                   └── link
@@ -355,33 +358,35 @@ The Notary v2 prototype adds referrer metadata for the **wabbit-networks** signa
 
 Adding the **acme-rockets** signature:
 
-- signature index digest: `sha256:333ic0c33ebc4a74a0a554c86ac2b28ddf3454a5ad9cf90ea8cea9f9e75c333i`
-- index json:
-
+- artifact digest: `sha256:333ic0c33ebc4a74a0a554c86ac2b28ddf3454a5ad9cf90ea8cea9f9e75c333i`
+- artifact json:
   ```json
   {
-    "schemaVersion": 2,
-    "mediaType": "application/vnd.oci.image.index.v2+json",
-    "config": {
-      "mediaType": "application/vnd.cncf.notary.config.v2+jwt",
-      "digest": "sha256:333cc44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b785c333c",
-      "size": 1906
-    },
-    "manifests": [
-      {
-        "mediaType": "application/vnd.oci.image.manifest.v1+json",
-        "digest": "sha256:111ma2d22ae5ef400769fa51c84717264cd1520ac8d93dc071374c1be49a111m",
-        "size": 7023,
-        "platform": {
-          "architecture": "ppc64le",
-          "os": "linux"
-        }
-      }
-    ]
-  }
+        "schemaVersion": 2,
+        "mediaType": "application/vnd.oci.artifact.manifest.v1+json",
+        "artifactType": "application/vnd.cncf.notary.v2",
+        "blobs": [
+          {
+            "mediaType": "application/vnd.cncf.notary.signature.v2+jwt",
+            "digest": "sha256:333cc44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b785c333c",
+            "size": 2338
+          }
+        ],
+        "manifests": [
+            {
+              "mediaType": "application/vnd.oci.image.manifest.v1+json",
+              "digest": "sha256:111ma2d22ae5ef400769fa51c84717264cd1520ac8d93dc071374c1be49a111m",
+              "size": 7023,
+              "platform": {
+                "architecture": "ppc64le",
+                "os": "linux"
+              }
+            }
+        ]
+    }
   ```
 
-The Notary v2 storage layout of 2 signature index objects:
+The storage layout of the two artifact referrer objects:
 
 ```
 <root>
@@ -394,7 +399,7 @@ The Notary v2 storage layout of 2 signature index objects:
                         ├── 111ma2d22ae5ef400769fa51c84717264cd1520ac8d93dc071374c1be49a111m
                         │   ├── link
                         │   └── ref
-                        │       └── application/vnd.cncf.notary.config.v2+jwt
+                        │       └── digest(application/vnd.cncf.notary.v2)
                         │           └── sha256
                         │               ├── 222cb130c152895905abe66279dd9feaa68091ba55619f5b900f2ebed38b222c
                         │               │    └── link

docs/distribution/prototype-example.md

@@ -130,7 +130,7 @@ curl -s "http://$registry/v2/_ext/oci-artifacts/v1/$repo/manifests/$manifestDige
 
 ```shell
 # Retrieve signature digest from first artifact.
-signatureDigest=`curl -s "http://$registry/v2/_ext/oci-artifacts/v1/$repo/manifests/$manifestDigest/references?artifact-type=$artifactType" | jq -r '.links[0].manifest.blobs[0].digest'` && \
+signatureDigest=`curl -s "http://$registry/v2/_ext/oci-artifacts/v1/$repo/manifests/$manifestDigest/references?artifact-type=$artifactType" | jq -r '.references[0].manifest.blobs[0].digest'` && \
   retrievedSignatureFile="retrieved-signature.json" && \
   curl -s http://$registry/v2/$repo/blobs/$signatureDigest > $retrievedSignatureFile