I recently saw this StackOverflow.com question about efficiently running tests for clang-format, which reminded me that clang-format has essentially nothing as written record for documentation from the perspective of someone working on the tool.
Running tests comes to mind first, since it is something I also struggled to figure out when first starting out contributing. Especially as someone with a poor setup, since compilation times lead to development downtime, running the tests in the most efficient possible way was very important to me.
There are more thing that could be there too, for example: We now have super neat Herald rules on Phabricator that point out potential flaws, but despite their convenience, I feel like they should be documented someone, both as a formality, and so they could be seen before actually making a patch.
My brief contribution to clang-tidy also reminds me that it has a great documentation page for contributing, which shows prior precedent.
Circling back to that original Stack Overflow question, I answered it to the best of my ability, how I figured out a way to run the tests as I started out, but I wanted to make this post for another reason too:
@owenpan, @mydeveloperday, @HazardyKnusperkeks, as the people I most look to for reviews, I wanted to ask your method for doing this, because maybe there really is a better way that should then be documented somewhere as the way to do it.