diff --git a/draft/spec/index.html b/draft/spec/index.html index 9504c58..5f95444 100644 --- a/draft/spec/index.html +++ b/draft/spec/index.html @@ -777,7 +777,7 @@

Version

the same digest in the manifest. See [[OCFL-Implementation-Notes]].

- An example state block is shown below: + An example state block is shown below:

   "state": {
@@ -786,9 +786,9 @@ 

Version

}

- This state block describes an object with 3 files, two of which have the same content - (empty.txt and empty2.txt), and one of which is in a - sub-directory (bar.xml). The logical state shown as a tree + This state block describes an object with 3 files, two of which have + the same content (empty.txt and empty2.txt), and one of which + is in a sub-directory (bar.xml). The logical state shown as a tree is thus:

@@ -843,18 +843,19 @@ 

Fixity

Digests section, or in a table given in an Extension. The value of the fixity block for a particular digest algorithm MUST follow the structure of the manifest block; that is, a key corresponding to the digest value, - and an array of content paths. The fixity block for any digest algorithm MAY include digest - values for any subset of content paths in the object. Where included, the digest values given + and an array of content paths. The fixity block for any digest algorithm MAY include + digest values for any subset of content paths in the object. Where included, the digest values given MUST match the digests of the files at the corresponding content paths. As JSON keys are case sensitive, while digests may not be, there is an additional requirement that each digest - value MUST occur only once in the fixity block for any digest algorithm, - regardless of case. There is no requirement that all content files have a value in the fixity block, or - that fixity values provided in one version are carried forward to later versions. + value MUST occur only once in the fixity block for any digest + algorithm, regardless of case. There is no requirement that all content files have a value in the + fixity block, or that fixity values provided in one version are carried forward to later + versions.

- An example fixity block with md5 and sha1 digests is shown below. In this - case the md5 digest values are provided only for version 1 content paths. + An example fixity with md5 and sha1 digests is shown below. In + this case the md5 digest values are provided only for version 1 content paths.

   "fixity": {
@@ -913,12 +914,12 @@ 

Version Inventory and Inventory Digest

In the case that prior version directories include an inventory file there will be multiple inventory - files describing prior versions within the OCFL Object. Each version block in each prior inventory file - MUST represent the same object state as the corresponding version block in the - current inventory file. Additionally, the values of the created, message and - user keys in each version block in each prior inventory file SHOULD - have the same values as the corresponding keys in the corresponding version block in the current inventory - file. + files describing prior versions within the OCFL Object. Each version block in each prior + inventory file MUST represent the same object state as the corresponding + version block in the current inventory file. Additionally, the values of the + created, message and user keys in each version block + in each prior inventory file SHOULD have the same values as the corresponding keys + in the corresponding version block in the current inventory file.

Non-normative note: Storing an inventory for every version provides redundancy for this critical @@ -1479,8 +1480,8 @@

Moab in an OCFL Object

Converting content preserved in a Moab object in a way that does not compromise existing Moab access patterns whilst allowing for the eventual use of OCFL-native workflows requires a Moab to OCFL conversion tool. This tool uses the Moab-versioning gem to extract deltas and digests - of the Moab data directory for each Moab version and translate those into version state blocks - in an OCFL inventory file, which would be placed in the root directory of the Moab object. + of the Moab data directory for each Moab version and translate those into version state + blocks in an OCFL inventory file, which would be placed in the root directory of the Moab object. The content of the data directory in the Moab version directories (and thus, the bitstreams that Moab is preserving) is tracked by OCFL, via the contentDirectory value. The contents of the Moab manifests directories are not tracked, as the intention is not