Improve coherence and source legibility of guide.md
#613
Conversation
Fix mixed content in css from WebVOWL
Among ontology metadata, add "Similar resource" (used) and remove "Label" (nonused); correct `vann:preferredNamespacePrefix` and `vann:preferredNamespaceURI`. Reshape tables; outsource links to ontology terms; correct links to best practice guide. Use coherently the prefixes `dce:` and `dcterms:` across tables and examples; remove ambiguous `dc:`.
Zack-83
changed the title
Zack-83
changed the title
Zack-83
changed the title
guide.md
|
Thanks @Zack-83. Can you please merge it in the |
| |Given name |[schema:givenName], [vcard:given-name], [foaf:givenname] |[Text] | | ||
| |Email |[schema:email], [vcard:hasEmail], [foaf:mbox] |[Text] | | ||
| |URL |[schema:url], [vcard:hasURL], [foaf:homepage] |[URI] | | ||
|
|
There was a problem hiding this comment.
Sorry, why are you removing all the links here? I added them in the first place because having them at the end of the document is a pain to go back and forth. Plus, that way you can copy the metadata property directly from the link instead of having to go to the back to the document all the time. I am fine if you also want to have them at the end of the doc, but I am against removing them here
There was a problem hiding this comment.
They are separated just in the source code, to improve legibility of the table. But the preview/rendering of the .md file shows the links correctly at the place they're supposed to be.
There was a problem hiding this comment.
Oh, I was not aware of this way of setting up links. Will merge then. Thanks!
| |Label |[rdfs:label], [skos:prefLabel], [obo:IAO_0000118]|[Sec 4.1] **[RECOMMENDED]**|[Text] |[ontology](#term)| | ||
| |Original source |[rdfs:isDefinedBy], [dce:source] |[Sec 4.3] **[OPTIONAL]** |[URI] |[ontology](#term)| | ||
| |Rationale |[vaem:rationale] |[Sec 4.6] **[OPTIONAL]** |[Text] |[ontology](#term)| | ||
| |Status |[sw:term_status], [obo:IAO_0000114] |[Sec 4.5.2] **[OPTIONAL]** |[Text] |[ontology](#term)| |
| |Source|[dce:source], [dcterms:source], [prov:hadPrimarySource]|source|[Sec 3.4.5] **[OPTIONAL]** |[URI] |[ontology](#onto), [config]| | ||
| |Title |[dce:title], [dcterms:title], [schema:name] |ontologyTitle |[Sec 3.2.1] **[RECOMMENDED]**|[Text]|[ontology](#onto), [config]| | ||
| |Version IRI |[owl:versionIRI] |thisVersionURI |[Sec 3.3.1] **[RECOMMENDED]**|[URI] |[ontology](#onto), [config]| | ||
| |Version number|[owl:versionInfo], [schema:schemaVersion]|ontologyRevisionNumber|[Sec 3.3.2] **[RECOMMENDED]**|[Text]|[ontology](#onto), [config]| |
There was a problem hiding this comment.
Please see comment about links below. I spent quite a lot of time adding them to the table for the very reason that they make my life easier when copy pasting.
|
@Zack-83 I do appreciate a lot your contributions. However, I don't want to merge this PR if the links in the tables are removed, as explained in my comments above. I plan to extend this metadata guide a bit further probably next week, based on some new analyses I have done. If you don't have the time, I will try to incorporate your other suggestions in my newer edits. |
Among ontology metadata, add "Similar resource" (used) and remove "Label" (nonused); correct
vann:preferredNamespacePrefixandvann:preferredNamespaceURI.Reshape tables; outsource links to ontology terms; correct links to best practice guide.
Use coherently the prefixes
dce:anddcterms:across tables and examples; remove ambiguousdc:.