atom: add doc links
fix indents
Merge pull request #2385 from borisyankov/def/atom

minor atom doc fixes