Use links instead of raw docs that don't link to the appropriate
methods. Adjust to say that the retry atoms really provide and
define the strategy to resolve surronding/associated failures.
Add link to what a scope is (in the computer science terms
usage).
Change-Id: I093862c368007ac761cf9d1e3b0f94be36ada13a