Improve a comment about std::atomic

@bluescarni, does it looks good to you?

@sushant-hiray, how should it be formatted, so that it shows correctly in the sphinx docs?
All the comments starting with `//!` will be rendered by the Sphinx documentation.
Do you wish to include the entire comment block?