docs: fix TestSuite toc
docs: document the `@debug` tag and free-form descriptions
docs: improve the test suite documentation
test suite: improve the step reference documentation
improve the test suite documentation
add test suite documentation