Improve coherence and source legibility of `guide.md`

dgarijo / Widoco

Wizard for documenting ontologies. WIDOCO is a step by step generator of HTML templates with the documentation of your ontology. It uses the LODE environment to create part of the template.

Apache License 2.0

284 stars 88 forks source link

Improve coherence and source legibility of `guide.md` #613

Closed Zack-83 closed 1 year ago

Zack-83 commented 1 year ago

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:.

dgarijo commented 1 year ago

Thanks @Zack-83. Can you please merge it in the develop branch? That's the one with the latest commits.

dgarijo commented 1 year ago

@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.