diff --git a/README.md b/README.md
index d9bbae39..3aa5ee81 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,12 @@
 # pybind11 utilities for XO projects
 
-# to build + install locally
+## Getting Started
+
+### build + install dependencies
+
+- see [github/Rconybea/xo-cmake](https://github.com/Rconybea/xo-cmake)
+
+### to build + install locally
 
 ```
 $ cd xo-pyutil
@@ -11,3 +17,9 @@ $ cmake -DCMAKE_MODULE_PATH=${PREFIX}/share/cmake -DCMAKE_PREFIX_PATH=$(PREFIX)
 $ make
 $ make install
 ```
+
+### LSP support
+```
+$ cd xo-pyutil
+$ ln -s build/compile_commands.json  # lsp will look for compile_commands.json in the root of the source tree
+```