diff --git a/docs/index.md b/docs/index.md
index 59b939ba..5f19987b 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -200,8 +200,17 @@ You will see a number of different styles of buttons, data entry fields, etc, in
 ### Installing
 
     pip install PySimpleGUI
- or
-Simply download the file - PySimpleGUI.py and import it into your code
+On some systems you need to run pip3.
+
+
+    pip3 install PySimpleGUI
+
+On a Raspberry Pi, this is should work:
+
+    sudo pip3 install --upgrade pysimplegui
+
+If for some reason you are unable to install using `pip`, don't worry, you can still import PySimpleGUI by downloading the file PySimleGUI.py and placing it in your folder along with the application that is importing it.
+
 
 
 ### Prerequisites
@@ -2024,3 +2033,4 @@ In the hands of a competent programmer, this tool is **amazing**.   It's a must-
 
 The PySimpleGUI window that the results are shown in is an 'input' field which means you can copy and paste the results right into your code.
 
+
diff --git a/readme.md b/readme.md
index 59b939ba..5f19987b 100644
--- a/readme.md
+++ b/readme.md
@@ -200,8 +200,17 @@ You will see a number of different styles of buttons, data entry fields, etc, in
 ### Installing
 
     pip install PySimpleGUI
- or
-Simply download the file - PySimpleGUI.py and import it into your code
+On some systems you need to run pip3.
+
+
+    pip3 install PySimpleGUI
+
+On a Raspberry Pi, this is should work:
+
+    sudo pip3 install --upgrade pysimplegui
+
+If for some reason you are unable to install using `pip`, don't worry, you can still import PySimpleGUI by downloading the file PySimleGUI.py and placing it in your folder along with the application that is importing it.
+
 
 
 ### Prerequisites
@@ -2024,3 +2033,4 @@ In the hands of a competent programmer, this tool is **amazing**.   It's a must-
 
 The PySimpleGUI window that the results are shown in is an 'input' field which means you can copy and paste the results right into your code.
 
+