clarity on manifest requirements in historic inventories

[pwinckles]

My understanding is that the spec requires that the manifest entry of every inventory version contains references to all of the content files in its version and all prior versions. If this is the case, I think the language in the spec could be more clear.

Here are the relevant texts:

Every file within a version's content directory MUST be referenced in the manifest section of the inventory.

And:

The value of the manifest key is a JSON object, with keys corresponding to the digests of every content file in all versions of the OCFL Object.

The second quote could be clarified by appending something along the lines of "at the time it was written" as it clearly cannot mean all versions. However, a change like that would still leave the door open for a later version to write a file to a prior version's content directory. Doing so would not violate the requirement for either inventory to reference all of the content files that existed at the time they were created.

The first quote seems to make the stronger requirement that a version's inventory must reference all of the files within its own content directory, but is left slightly ambiguous because it is not clear which inventory "the inventory" is referring to.