Prov-WD: Conflicting description of DatasetDescription.contentType

Ole Streicher ole at aip.de
Mon Jul 15 17:15:28 CEST 2019


See pg 4:

"The words “MUST”, “SHALL”, “SHOULD”, “MAY”, “RECOMMENDED”, and
“OPTIONAL” (in upper or lower case) used in this document are to be
interpreted as described in IETF standard, Bradner (1997)."

So, case does not matter.

Best

Ole


On 15.07.19 17:08, François Bonnarel wrote:
> Well,
>
> Here in the text may is in small letters, it's not the keyword MAY I
> guess.
>
> Regards
>
> François
>
>
> Le 15/07/2019 à 16:53, Ole Streicher a écrit :
>> Hi again,
>>
>> (third and last issue concerning special Entity classes):
>>
>> The DatasetDescription has a mandatory "contentType" attribute, which is
>> described in the text in the following manner (2.6.1 "DatasetEntity and
>> DatasetDescription classes", pg. 26):
>>
>> "The contentType _may_ indicate the MIME-type or format of a file,
>> or a more precise structure, following the definition of the attribute
>> access_format defined in ObsCoreDM [...]"
>>
>> According to the prequel (pg. 4), the word "_may_" here has the meaning
>> <https://www.ietf.org/rfc/rfc2119.txt>:
>>
>> "MAY  This word, or the adjective "OPTIONAL", mean that an item is truly
>> optional."
>>
>> which is obviously not what is meant here. Fixed in the attachment. The
>> fix also changes "file" --> "dataset", since a DataSet is not restricted
>> to a file (see previous issue).
>>
>> Best
>>
>> Ole
>


More information about the dm mailing list