Merge pull request #4833 from authmillenon/core/doc/why-struct

doc: atomic: provide explanation about why atomic_int_t is struct

core/include/atomic.h

@@ -27,6 +27,9 @@ extern "C" {
 
 /**
  * @brief Integer variable for use in atomic counters.
+ *
+ * @note    This type is a struct for hard type checking (let the compiler warn
+ *          if int is assigned regularly).
  */
 typedef struct atomic_int {
     volatile int value;         /**< the actual value */