diff --git a/crates/ra_cfg/src/cfg_expr.rs b/crates/ra_cfg/src/cfg_expr.rs
index 811f830488..39d71851ca 100644
--- a/crates/ra_cfg/src/cfg_expr.rs
+++ b/crates/ra_cfg/src/cfg_expr.rs
@@ -1,3 +1,7 @@
+//! The condition expression used in `#[cfg(..)]` attributes.
+//!
+//! See: https://doc.rust-lang.org/reference/conditional-compilation.html#conditional-compilation
+
 use std::slice::Iter as SliceIter;
 
 use ra_syntax::SmolStr;
diff --git a/crates/ra_hir/src/attr.rs b/crates/ra_hir/src/attr.rs
index a8a7e90061..f67e80bfd1 100644
--- a/crates/ra_hir/src/attr.rs
+++ b/crates/ra_hir/src/attr.rs
@@ -1,3 +1,5 @@
+//! A higher level attributes based on TokenTree, with also some shortcuts.
+
 use std::sync::Arc;
 
 use mbe::ast_to_token_tree;