Updated pip installation instructions

KP · KP · commit 439979ccd44e · 2012-12-19T12:44:38.000-06:00
Recommend installing specific tagged versions over master.
diff --git a/README.mdown b/README.mdown
@@ -20,9 +20,17 @@ Shotgun provides a simple Python-based API for accessing Shotgun and integrating
 To use Shotgun's Python API module, you need to place the package shotgun_api3 in one of the directories specified by the environment variable PYTHONPATH. For more information on PYTHONPATH and using modules in Python, see http://docs.python.org/tutorial/modules.html
 
 ### Installing with `pip`
-To install this package with `pip`, run the following command:
+
+#### Specific Versions 
+To install a specific version of the package with `pip` (recommended), run the following command 
+(This example installs the v3.0.9 tag. Replace the version tag with the one you want):  
+`pip install -e git://github.com/shotgunsoftware/python-api.git@v3.0.9#egg=shotgun_api3`
+ 
+#### Master 
+If you wish to install the current master, use the following command (Note that we try and keep master stable but it may contain issues. Tags are the current stable versions of the API):  
 `pip install -e git://github.com/shotgunsoftware/python-api.git#egg=shotgun_api3`
 
+#### requirements.txt
 If you're using pip with `requirements.txt`, add the following line:
 `-e git://github.com/shotgunsoftware/python-api.git#egg=shotgun_api3`
 
