Rework atom documentation

Expand on what atoms, tasks, and retries
are used for an what there mission is and
explain in more depth (with usage examples)
how retry atoms can be used to resolve failures
that happen.

Change-Id: Icc585c8a9b87e070f12a267e531225f87412cd5f
Merge "Rework atom documentation"