diff --git a/README.md b/README.md
index 54004ff..58a3b25 100644
--- a/README.md
+++ b/README.md
@@ -24,6 +24,17 @@ Example config:
 (add-hook 'php-mode-hook #'my-php-personal-hook)
 ```
 
+## Install
+
+```bash
+git clone https://git.sr.ht/~hugot/phpinspect.el ~/projects/phpinspect.el
+```
+
+```elisp
+(add-to-list 'load-path "~/projects/phpinspect.el")
+(require 'phpinspect)
+```
+
 ## Development
 
 ### Running tests
diff --git a/phpinspect.el b/phpinspect.el
index f59dee3..7283de2 100644
--- a/phpinspect.el
+++ b/phpinspect.el
@@ -1882,6 +1882,10 @@ users will have to use \\[phpinspect-purge-cache]."
   "A minor mode for intelligent completion for and interaction
 with PHP files.
 
+To initially index a project, use M-x `phpinspect-index-current-project'
+in a buffer of one of the project files. Project root is detected with
+`phpinspect-project-root-file-list'.
+
 For completion see the company-mode backend:
 `phpinspect-company-backend'.