doc: adapted tests according to latest meeting and fixed linting warnings

Adapted test suite according to the meeting decisions.

Also fixed some linting warnings on the document and some markdown heading styles.