DOI-DO / dcat-us

Data Catalog Vocabulary (DCAT) - United States Profile Chief Data Officers Council & Federal Committee on Statistical Methodology
Other
58 stars 6 forks source link

Clarity on documenting linguistic metadata would be helpful. #179

Closed sofianef closed 9 months ago

sofianef commented 10 months ago

Name: Carrie Comstock

Affiliation: USEPA Office of Research and Development (ORD), Cummings.Carrie@EPA.gov

Type of issue: Schema, Editorial

Section # / Table #: 5.18.3 Distribution's language property

Issue:

Original email submission: USEPA-ScienceHub-FAIRness.Project.-.DCAT-US-3-AP.-.Comment.Review.Matrix.xlsx

fellahst commented 10 months ago

The following updates been done:

ShaferAC commented 9 months ago

+1; Comment: There appears to be a ">" at the start of the Usage note about "Resources defined by the Library of Congress..." - should the arrow be removed?

In the dcterms:language description for dcat:Distribution - the 2nd and 3rd Usage notes seem a little redundant. I think the 3rd one is more concise and easier to understand. The dcterms:language for dcat:Dataset seems to use the same language as the 2nd Usage note in dcterms:language for dcat:Distribution. If it is decided to keep only the 3rd usage note, then we should probably update dcat:Dataset's dcterms:language usage note for consistency.

mrratcliffe commented 9 months ago

+1

fellahst commented 9 months ago

@ShaferAC,

Thank you for pointing out the typographical error and providing feedback on the usage notes in the DCAT-US profile. Your keen observation and suggestions are essential for maintaining the clarity and consistency of the documentation.

  1. Typographical Error: We have addressed the issue with the stray ">" character at the start of the usage note about "Resources defined by the Library of Congress...". We found 5 similar typos. This character was indeed not intended to be part of the text and has been removed for clearer readability.

  2. Usage Notes on dcterms:language for dcat:Distribution and dcat:Dataset: After reviewing your comments regarding the redundancy in the usage notes, we agree that the third usage note is more concise and effectively communicates the necessary information. Therefore, we have removed the second usage note for dcterms:language under dcat:Distribution to eliminate redundancy. This change will help maintain uniformity and clarity in the documentation.