diff --git a/docs/source/installation/linux.rst b/docs/source/installation/linux.rst
index 74e6f74f..e8ff6d72 100644
--- a/docs/source/installation/linux.rst
+++ b/docs/source/installation/linux.rst
@@ -30,6 +30,11 @@ Plugin installation
    project is currently unavailable on the PyPI due to a naming conflict 
    with an unrelated project.
 
+.. note:: If you are powerline developer you should be aware that ``pip install 
+   --editable`` does not currently fully work. If you
+   install powerline this way you will be missing ``powerline`` executable and 
+   need to symlink it. It will be located in ``scripts/powerline``.
+
 Font installation
 =================
 
diff --git a/docs/source/installation/osx.rst b/docs/source/installation/osx.rst
index aa029f11..c991eac7 100644
--- a/docs/source/installation/osx.rst
+++ b/docs/source/installation/osx.rst
@@ -26,6 +26,11 @@ Python package
    project is currently unavailable on the PyPI due to a naming conflict 
    with an unrelated project.
 
+.. note:: If you are powerline developer you should be aware that ``pip install 
+   --editable`` does not currently fully work. If you
+   install powerline this way you will be missing ``powerline`` executable and 
+   need to symlink it. It will be located in ``scripts/powerline``.
+
 Vim installation
 ----------------