SuccessReason: add some explanatory comments

Whenever I look at dependency calculation, it takes me a while to get my
head round the concept of influences. If what I've written here is
accurate, maybe the next person to look at this (or my future self)
will need less of a run-up.
Merge branch 'ready/document-success-reason'
add more wording based on what chrysn suggested