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

Closes #3636

Signed-off-by: Doug Davis <dug@us.ibm.com>
Probably expand on this - mention perhaps the `RUN` instruction specifically.