Add more info about when build cache is invalidated/used - Issue #3636

Plus some edits as suggested by @jamtur01

Closes #3636

Signed-off-by: Doug Davis <dug@us.ibm.com>