diff --git a/README.md b/README.md
index f8d59410a252..8fce0609cce6 100644
--- a/README.md
+++ b/README.md
@@ -193,7 +193,7 @@ parameters:
 
 ### Import Use Statements
 
-FQN classes are imported by default every time Rector performs a change,  so you don't have to do it manually/after each run. You can disable it by:
+FQN classes are imported by default every time Rector performs a change, so you don't have to do it manually/after each run. You can disable it by:
 
 ```yaml
 # rector.yaml
@@ -201,6 +201,15 @@ parameters:
     auto_import_names: false
 ```
 
+You can also fine-tune how these imports are processed using these two options :
+
+```yaml
+# rector.yaml
+parameters:
+    import_short_classes: false # this will not import root namespace classes, like \DateTime or \Exception
+    import_doc_blocks: false # this will not import classes used in PHP DocBlocks, like in /** @var \Some\Class */
+```
+
 ### Limit Execution to Changed Files
 
 Execution can be limited to changed files using the `process` option `--match-git-diff`.