use of markdown in comments

[VladimirAlexiev]

A bit of markdown is already used in the CBV ontology. This is a good practice, especially for more complex definitions, and it's rendered by doc generators such as LODE.

Proposed guidelines (see example in #209):

• If the ontology source is switched to Turtle, use """ and real newlines instead of \n
• Use backticks to delineate props, classes and keywords (eg OBSERVE)
• Use nested bulleted lists if needed
• Be consistent, eg here I think that bold was meant in both cases:
  • cbv:Disp-completeness_verified:
  • comment: indicate the **inferred** integrity
  • example: A downstream recipient *verifies* that <<< bold?

[mgh128]

Thanks for the feedback. I'll add those changes to my to-do list. They don't have an adverse impact on the group, so they're really just an implementation detail for the ontology browser tool and the ontology file.

I'm aware that there are keywords and reserved names for properties and classes that are not formatted as code style / monotype Courier font in the drafts. They also need to be fixed there.