RDF elements descriptions
Open
Nobody has claimed this yet.
- Dominant language
- Python
- Stars
- 11
- Forks
- 13
- PR merge metrics
- No merged PRs in 30d
Description
Feedback from OMG:
- Every element in your ontology should be declared and have, at a minimum, an rdfs:label and skos:definition. That would require adding the namespace for SKOS (Simple Knowledge Organization System, which is a W3C recommendation) to the header of your file, and then using skos:definition throughout rather than rdfs:comment. Definitions should be expressed using ISO 704 style, which is an expression that does not start with an upper case letter (unless the word is a proper noun), does not end in punctuation, and is not a full sentence. It should be something you can use to replace the name of the concept/class in a sentence. Any other details should be in skos:note, or similar annotation. We define a number of useful annotations in the Commons Annotation Vocabulary at the URI given in 4. You might consider importing it if any of them are useful to you. Certainly for the copyright statement you should consider doing so.
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Locate the ontology file and inspect its header and element declarations. Add the SKOS namespace, ensure each element has an rdfs:label and skos:definition, and replace rdfs:comment where appropriate. Done means definitions follow the stated ISO 704 style, with additional details moved to suitable annotations such as skos:note.
Written by the indexing model from the issue text.
Assessment
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 45/100