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?
I see, thanks. I think it's fine as it is, i.e. only visible in the source file.