1 files changed, 5 insertions, 0 deletions

diff --git a/crates/ra_analysis/src/completion/completion_item.rs b/crates/ra_analysis/src/completion/completion_item.rs
index 322a7c6be..445d6bf41 100644
--- a/crates/ra_analysis/src/completion/completion_item.rs
+++ b/crates/ra_analysis/src/completion/completion_item.rs
@@ -1,3 +1,6 @@
+/// `CompletionItem` describes a single completion variant in the editor pop-up.
+/// It is basically a POD with various properties. To construct a
+/// `CompletionItem`, use `new` method and the `Builder` struct.
 #[derive(Debug)]
 pub struct CompletionItem {
     label: String,
@@ -41,6 +44,7 @@ impl CompletionItem {
     }
 }
 
+/// A helper to make `CompletionItem`s.
 #[must_use]
 pub(crate) struct Builder {
     label: String,
@@ -76,6 +80,7 @@ impl Into<CompletionItem> for Builder {
     }
 }
 
+/// Represents an in-progress set of completions being built.
 #[derive(Debug)]
 pub(crate) struct Completions {
     buf: Vec<CompletionItem>,