Restructuring content into sections for reading and writing manifest data

Author: crandmck

docs/manifest/json-ref/index.md

@@ -6,11 +6,4 @@ pagination_next: null
 pagination_prev: null
 ---
 
-The [C2PA specification](https://c2pa.org/specifications/specifications/2.1/specs/C2PA_Specification.html#_manifests) describes a manifest with a binary structure in JPEG universal metadata box format ([JUMBF](https://www.iso.org/standard/84635.html)) that includes JSON as well as binary data for things like encryption keys and thumbnail images. Because the binary structure is hard to understand and program to, the SDK defines a JSON manifest structure that's a declarative language for representing and creating a binary manifest.
-
-The JSON manifest is an abstract translation layer that's easier to understand than the binary format. It can describe everything in the underlying binary format except for binary data such as thumbnails that are included by a structure called a _resource reference_. To generate a binary manifest, the SDK assembles all the JSON objects, resource references, and ingredients defined, and then converts them into different assertions and other objects as required.
-
-These JSON references are generated from the JSON schemas for [ManifestDefinition](https://docs.rs/c2pa/latest/c2pa/struct.ManifestDefinition.html) and [Reader](https://docs.rs/c2pa/latest/c2pa/struct.Reader.html) objects (_structs_ in Rust terminology):
-
-- [ManifestDefinition](manifest-def.mdx): Defines a manifest and builds a manifest store.
-- [Reader](reader.mdx): Reads and validates a manifest.
+No longer used.

docs/manifest/legacy-assertions.md

@@ -0,0 +1,17 @@
+---
+id: legacy-manifests
+title: Reading legacy manifest data
+---
+
+An application should write manifest data that conforms to the recent [version 2.2](https://c2pa.org/specifications/specifications/2.2/specs/C2PA_Specification.html) C2PA technical specification, but should be abel to read and validate manifest data that conforms to earlier versions of the specification.  This ensures that your application is "backward-compatible" and can still validate older assets with claims that were written in the past.
+
+<div class="review-comment">
+
+`c2pa.data_mining` > `cawg.data_mining`, etc. were renamed, with xref.
+
+`SoftwareAgent` is now a structure
+
+`digitalSourceType` is now required on every ingredient, previously it was not.
+
+For READING old claims (only) … v1 actions and ingredients
+</div>

docs/manifest/legacy.md

@@ -0,0 +1,13 @@
+---
+id: reading
+title: Reading and validating manifest data
+---
+
+Use a [Reader](json-ref/reader.mdx) structure when reading and validating manifest data. The Rust library and other language libraries provide methods and objects for working with this structure.
+This JSON reference is generated from the JSON schema for [Reader](https://docs.rs/c2pa/latest/c2pa/struct.Reader.html) objects (_struct_ in Rust terminology).
+
+- [Ingredients](manifest/ingredients.md)
+- [CAWG identity assertions](manifest/cawg-id.md)
+- [Reading legacy manifest data](manifest/legacy.md)
+- [Validating manifests](manifest/validation.md)
+- [Reader JSON reference](manifest/json-ref/reader.mdx)

docs/manifest/reading.md

@@ -0,0 +1,9 @@
+---
+id: writing
+title: Building and writing manifest data
+---
+
+Use a [ManifestDefinition](json-ref/manifest-def.mdx) structure to define and construct manifest data for writing. The Rust library and other language libraries provide methods and objects for working with this structure.  This JSON reference is generated from the JSON schema for [ManifestDefinition](https://docs.rs/c2pa/latest/c2pa/struct.ManifestDefinition.html) object (_struct_ in Rust terminology).
+
+- [Assertions and actions](manifest/assertions-actions.md)
+- [ManifestDefinition JSON reference](manifest/json-ref/manifest-def.mdx)

docs/manifest/writing.md

@@ -29,51 +29,59 @@ const sidebars = {
     },
     {
       type: 'category',
-      label: 'Understanding manifests',
+      label: 'Working with manifests',
       link: { type: 'doc', id: 'manifest/understanding-manifest' },
       collapsed: true,
       items: [
         {
-          type: 'doc',
-          id: 'manifest/assertions-actions',
-        },
-        {
-          type: 'doc',
-          id: 'manifest/ingredients',
-        },
-        {
-          type: 'doc',
-          id: 'manifest/manifest-validation',
-        },
-        {
-          type: 'doc',
-          id: 'manifest/cawg-id',
-        },
-        {
-          type: 'doc',
-          id: 'manifest/legacy-manifests',
-        },
-        {
-          type: 'doc',
-          id: 'manifest/manifest-examples',
-          label: 'Examples',
+          type: 'category',
+          label: 'Reading manifest data',
+          link: { type: 'doc', id: 'manifest/reading' },
+          collapsed: true,
+          items: [
+            {
+              type: 'doc',
+              id: 'manifest/ingredients',
+            },
+            {
+              type: 'doc',
+              id: 'manifest/cawg-id',
+            },
+            {
+              type: 'doc',
+              id: 'manifest/legacy-manifests',
+            },
+            {
+              type: 'doc',
+              id: 'manifest/manifest-validation',
+            },
+            {
+              type: 'doc',
+              id: 'manifest/json-ref/reader',
+            },
+          ],
         },
         {
           type: 'category',
-          label: 'JSON reference',
-          link: { type: 'doc', id: 'manifest/json-ref/index' },
+          label: 'Writing manifest data',
+          link: { type: 'doc', id: 'manifest/writing' },
           collapsed: true,
           items: [
             {
               type: 'doc',
-              id: 'manifest/json-ref/manifest-def',
+              id: 'manifest/assertions-actions',
             },
             {
               type: 'doc',
-              id: 'manifest/json-ref/reader',
+              id: 'manifest/json-ref/manifest-def',
             },
           ],
         },
+        {
+          type: 'doc',
+          id: 'manifest/manifest-examples',
+          label: 'Examples',
+        },
       ],
     },
     {