[tdwg-humboldt] Markdown version of isLeastSpecificTargetCategoryQuantityInclusive Guidelines

[Baskauf, Steven James]

Hi folks,

I’ve done a conversion of the isLeastSpecificTargetCategoryQuantityInclusive Guidelines to Markdown. You can see the draft at:

https://github.com/baskaufs/msc/blob/master/docs/inclusive.md

When it’s good enough, I’ll submit it as a pull request to somewhere in the Humboldt repo.

Notes:

1. In the Google Doc, some text earlier in the doc repeated what was in the Examples section, so I deleted it.
2. I added the standard status (1.1) and RFC 2119 keyword section (1.2) section. After reading the doc, it seems that only section 3 is normative, so I stated that, and labeled all of the major sections as to whether they were normative or not. I made a few changes to section 3 so that the RFC 2119 keywords were include where I though they needed to be, so please read that section again to make sure that these prescriptive wordings make sense.
3. I can’t remember who did the work of writing the doc, so please check the contributors section at the top to make sure I got it right.
4. I made up an abstract from info in the introduction.
5. I split the Introduction and Rationale into 2 separate sections to follow the pattern of other TDWG documents: having an initial introductory section, the technical sections (1.1-1.3) then the main text. This seemed to work out if I split the first paragraph out and used it for the intro and put the rest into rationale.

IMPORTANT:
I was rigorous in distinguishing between text that referred to abbreviated term IRIs (like dwc:Event) and colloquial use of terms (like “organism”) by putting the abbreviated term IRIs (and literal values) in code markup as has been standard practice in other documents. However, there were many places in the document where it straddled the fence by using capitalized words like “Event”, “Taxon”, or “Organism”. These either were term IRIs or they weren’t. Since they weren’t prefixed by a namespace abbreviation, I assumed they were just nouns and not term IRIs and I changed them to lower case. If that was not the intention and “dwc:Event”, “dwc:Taxon”, and “dwc:Organism” were intended, then they should all be re-capitalized and prepended with a namespace abbreviation. We can discuss what was intended at our meeting tomorrow and I’ll change them as necessary.

See you in the morning.

Steve

--
Steven J. Baskauf, Ph.D.  he/him/his
Data Science and Data Curation Specialist / Librarian III
Jean & Alexander Heard Libraries, Vanderbilt University
Nashville, TN 37235, USA

Biodiversity Information Standards (TDWG) Executive Committee/Technical Architecture Group Chair
https://baskauf.github.io/

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.tdwg.org/pipermail/tdwg-humboldt/attachments/20230517/6d10d1a8/attachment.html>