Although we do not use the BODS acronym in the text, it does appear in the image. I think we should re-write this as "Beneficial Ownership Data Standard (BODS) version 2" or similar

The following is paraphrased from the Github issue at https://github.com/openownership/data-standard/issues/264 .....

Inline markup like hyperlinks is currently included in some description fields in the schema. So far, markdown has been used. There's no guarantee or expectation that the schema JSON will be rendered by something that can parse markdown resulting in bugs like this

The JSON descriptions should really be plaintext strings, as they don't have a media-type indicator of any kind to say how they should be treated otherwise.

There is a proposal to remove all kinds of inline markup from the schema descriptions. If hyperlinks are needed, they can simply be written out, eg. "..based on the EC ISA Core Person Vocabulary (https://joinup.ec.europa.eu/solution/e-government-core-vocabularies) definitions."

If in agreement, the style guide should also be updated to note this.

Adding this annotation to test notifications