There has been a lot of discussion recently around checking and verifying the generated documentation (checking for broken links, bad html etc)

These types of tests can be placed in a new jtreg test root called "docs", as to not make the rest of the tests depend on the docs as a dependency