Adding atomics usage sentence with an example test

Author: borsakv

src/concurrency.md

@@ -145,6 +145,33 @@ The following table lists the atomic types and the corresponding primitive types
 | `usize`        | [`core::sync::atomic::AtomicUsize`]   |
 | `*mut T`       | [`core::sync::atomic::AtomicPtr<T>`]  |
 
+r[concurrency.atomics.usage]
+Atomic types are [`Sync`], meaning references to them can be safely shared between threads. Using atomic operations correctly may require careful reasoning about memory ordering.
+
+```rust
+use std::sync::atomic::{
+    AtomicBool, AtomicI8, AtomicI16, AtomicI32, AtomicI64,
+    AtomicIsize, AtomicU8, AtomicU16, AtomicU32, AtomicU64,
+    AtomicUsize,
+};
+
+fn assert_sync<T: Sync>() {}
+
+fn main() {
+    assert_sync::<AtomicBool>();
+    assert_sync::<AtomicI8>();
+    assert_sync::<AtomicI16>();
+    assert_sync::<AtomicI32>();
+    assert_sync::<AtomicI64>();
+    assert_sync::<AtomicIsize>();
+    assert_sync::<AtomicU8>();
+    assert_sync::<AtomicU16>();
+    assert_sync::<AtomicU32>();
+    assert_sync::<AtomicU64>();
+    assert_sync::<AtomicUsize>();
+}
+```
+
 [concurrent programs]: glossary.md#concurrent-program
 [data races]: glossary.md#data-race
 [`Send`]: special-types-and-traits.md#send