DOC: add docs on using the `build-dir` config setting

[rgommers]

Closes gh-540

Also touches on gh-246, which is a common enough hiccup that it's useful to explicitly show dealing with meson-log.txt in CI.