Make it obvious which linter names go with which descriptions

and add links to more details later in the docs.