[Proposal] Consolidate the attributes of document and asset elements in the manifest.xml

[ghost]

Hello,

the attributes of the <document /> and <asset /> elements in the manifest.xml file should be consolidated.

Attributes in the Spec

Right now in the specs I find traces of the following attributes:

• id: The id of the asset/document
• mime-type: The mime type of the asset/document
• name: The name of the asset/document
• path: The path of the asset/document relative to the Dar it pertains to
• type: The (structural) type the asset/resource represents

Attributes in the dar-server responses

Furthermore, the dar-server in it's response format returns other attributes describing a resource which in my opinion might also be worthwile to add to the set of allowed attributes for the <document /> and <asset /> elements:

• encoding: The encoding of the asset/document
• size: The size of the asset/document in Bytes(?)
• createdAt: The date an asset/document has been created
• updatedAt: The date an asset/document has been updated

mime-type and type

I would have three proposals regarding these two attributes:

Make the mime-type attribute mandatory for all <asset /> and <document /> elements since it might be helpful on the backend-side when it comes to serializing/deserializing a resource. Right now this doesn't seem to be the case.

Be strict regarding the allowed values of these two attributes. With regards to the mime-type attribute this shouldn't be a problem since the values are already defined and standardized (see here). Regarding the values of the type attribute I'm pretty sure that there is exists some sort of controlled vocabulary relating to document types.

Change the attribute name mime-type to media-type as this seems to be the standard now.

[RFC2046] specifies that Media Types (formerly known as MIME types) and Media
Subtypes will be assigned and listed by the IANA.

Source