[bact]

Will resolve #1088

Please suggest style/format of the definition list.

--

Currently, it put terms as a H2 heading, with definition as following paragraphs.

As a result, terms will also showing in the side navigation bar.

--

Alternatively, it is also possible in MkDocs to use a Markdown syntax to generate standard HTML tags for a definition list (<dl> for list, <dt> for term, and <dd> for description), which in general will work better with a screen reader:

• https://www.markdownguide.org/extended-syntax/#definition-lists
• https://python-markdown.github.io/extensions/definition_lists/

This code:

Profile

:   A scope of usage for SPDX targeting support for particular use cases and scenarios (e.g., software, licensing, security, etc.).

    A profile identifies which particular SPDX namespaces, classes, and properties it leverages, along with any custom constraints unique to its use.

Test

:   Test test

will generate

--

Which one we prefer?

With the compatibility with our current PDF generation in mind.

[goneall]

LGTM