[clang-tidy] Add a couple of paragraphs on run-clang-tidy.py to the docs.

Happy tidying.
run-clang-tidy: Make clang-tidy path configurable and don't fail as horribly
when it's not around.