Mention the need for a driver and how to get one in python documentation

Fixes #2931
SeleniumHQ · Oct 19, 2016 · 36e67cc · 36e67cc
1 parent 2e09979
commit 36e67cc
Show file tree

Hide file tree

Showing 2 changed files with 22 additions and 122 deletions.
diff --git a/py/README.rst b/py/README.rst
diff --git a/py/README.rst b/py/README.rst
@@ -0,0 +1 @@
+docs/source/index.rst
diff --git a/py/docs/source/index.rst b/py/docs/source/index.rst
@@ -27,7 +27,7 @@ Supported Python Versions
 =========================
 
 * Python 2.6, 2.7
-* Python 3.2+
+* Python 3.3+
 
 Installing
 ==========
@@ -42,6 +42,26 @@ Alternately, you can download the source distribution from `PyPI <http://pypi.py
 
 Note: both of the methods described above install `selenium` as a system-wide package  That will require administrative/root access to their machine.  You may consider using a `virtualenv <http://www.virtualenv.org/>`_ to create isolated Python environments instead.
 
+Drivers
+=======
+
+Selenium requires a driver to interface with the chosen browser. Firefox,
+for example, requires `geckodriver <https://github.com/mozilla/geckodriver/releases>`_, which needs to be installed before the below examples can be run. Make sure it's in your `PATH`, e. g., place it in `/usr/bin` or `/usr/local/bin`.
+
+Failure to observe this step will give you an error `selenium.common.exceptions.WebDriverException: Message: 'geckodriver' executable needs to be in PATH.`
+
+Other supported browsers will have their own drivers available. Links to some of the more popular browser drivers follow.
+
++--------------+-----------------------------------------------------------------------+
+| **Chrome**:  | https://sites.google.com/a/chromium.org/chromedriver/downloads        |
++--------------+-----------------------------------------------------------------------+
+| **Edge**:    | https://developer.microsoft.com/en-us/microsoft-edge/tools/webdriver/ |
++--------------+-----------------------------------------------------------------------+
+| **Firefox**: | https://github.com/mozilla/geckodriver/releases                       |
++--------------+-----------------------------------------------------------------------+
+| **Safari**:  | https://webkit.org/blog/6900/webdriver-support-in-safari-10/          |
++--------------+-----------------------------------------------------------------------+
+
 Example 0:
 ==========