Add information about the identifiers used by Mondo to the README

[gaurav]

I noticed that the information on constructing a Mondo identifier is currently located in two places:

1. http://obofoundry.org/id-policy says that the URI "http://purl.obolibrary.org/obo/" IDSPACE "_" LOCALID should be used.
2. https://mondo.readthedocs.io/en/latest/editors-guide/f-entities/ says that "All classes are in MONDO ID space"

I really like how the LOINC User Guide (in section 12.7.2) clearly describes how to construct an RDF URI for a LOINC concept, and I think it would be great to include this information in Mondo's documentation somewhere.

In this PR I propose a short paragraph on the main README page in a new section entitled "Identifiers" that would contain this information. If there is a better place to place this document (e.g. the editor's guide linked to above), let me know and I'll make a PR to target that file itself. Feel free to change my proposed wording or move it another file if that would be better.

[matentzn]

This content is correct and very much appreciated, but it needs to go into the "Mondo user guide". I can only find an editors guide and a developer guide.

@nicolevasilevsky What would be the best place to put such content? Should we start building a "user guide"?

[nicolevasilevsky]

on our readthedocs documentation, we actually have a "user's corner" on the left hand nav, but I have my doubts if many users know that is there. Screenshot pasted below

---

I've always thought the website was meant to be more of the user documentation. But then there was talk at some point about merging the website and the readthedocs site, which I am in favor of.

I think a more prominent users guide is a great idea.

At C-Path, we are going to have a week-long hackathon in a few weeks where we are going to focus on documentation. Maybe Mondo should consider a 1 or 2 day hackathon to focus on revising + updating documentation and aggregating and reorganizing all of the docs?

[twhetzel]

small change requested

[gaurav]

My FHIR RDF colleagues pointed out one other thing I missed in addition to Trish's feedback:

• Add a note either here or on the MONDO codesystem page on terminology.hl7.org asking users to use MONDO identifiers instead of CURIEs, i.e. when representing MONDO:0005015 "diabetes mellitus" in FHIR, they should use system=http://purl.obolibrary.org/obo/mondo.owl and code=0005015 rather than code=MONDO:0005015 (see discussion at Figure out a way to handle CURIES alongside IRI stems w3c/hcls-fhir-rdf#127).

[gaurav]

@nicolevasilevsky:

on our readthedocs documentation, we actually have a "user's corner" on the left hand nav, but I have my doubts if many users know that is there. Screenshot pasted below

I've updated this PR add an 'Identifiers' page to the Mondo User Guide -- I'm not sure what other content would make sense on that page, but if this approach makes more sense than adding this paragraph to the README, then that would be fine by me too!

[matentzn]

Lets merge this and reconsider it during our Mondo documentation hackathon in June!

[nicolevasilevsky]

Lets merge this and reconsider it during our Mondo documentation hackathon in June!

when is the hackathon in June?

[matentzn]

when is the hackathon in June?

No date yet.

[gaurav]

Lets merge this and reconsider it during our Mondo documentation hackathon in June!

That sounds good to me, but of course I don't get a vote :)

[matentzn]

@gaurav thank you for your patience and contribution here! Really sorry it took so long! We highly appreciate any further suggestions as well :)