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>
Merge pull request #8280 from duglin/Issue3636

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