Extend Sphinx documentation (mherrmann#43)

Thank you @IgnisDa1

Author: IgnisDa

README.md

@@ -100,6 +100,8 @@ documentation for Helium's various functions. Otherwise, please look at
 functions. I have not yet had time to bring this into a more readable state,
 sorry.
 
+The documentation for this project can be found [here](https://selenium-python-helium.readthedocs.io/en/latest/).
+
 ## Status of this project
 
 I have too little spare time to maintain this project for free. If you'd like

docs/conf.py

@@ -1,6 +1,5 @@
 import os
 import sys
-
 from datetime import date
 
 sys.path.insert(0, os.path.abspath('..'))
@@ -46,5 +45,3 @@
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
 html_static_path = ['_static']
-
-# autodoc_member_order = 'bysource'

docs/contributors.rst

@@ -5,5 +5,5 @@ Contributors to this project
     `SocialUsernameName <Profile-Url>`_ (**Your Name**) - *Description of your contribution in a few words*
 
 - `mherrmann <https://github.com/mherrmann>`_ (**Michael Herrmann**) - *Project creator and maintainer*
-- `IgnisDa <https://github.com/IgnisDa>`_ (**Diptesh Choudhuri**) - *Added documentation*
+- `IgnisDa <https://github.com/IgnisDa>`_ (**Diptesh Choudhuri**) - *Documentation maintainer*
 

docs/getting-started.rst

@@ -0,0 +1,40 @@
+Getting started with Helium
+===========================
+
+Installing Helium
+^^^^^^^^^^^^^^^^^
+
+To get started with Helium, you need Python 3 and Chrome or Firefox.
+
+If you already know Python, then the following command should be all you need:
+
+
+.. code-block:: bash
+
+    pip install helium
+
+Otherwise - Hi! I would recommend you create a virtual environment in the
+current directory. Any libraries you download (such as Helium) will be placed
+there. Enter the following into a command prompt:
+
+.. code-block:: bash
+
+    python3 -m venv venv
+
+This creates a virtual environment in the `venv/` directory. To activate it:
+
+.. code-block:: bash
+
+    # On Mac/Linux, bash shell:
+    source venv/bin/activate
+    # On Windows:
+    call venv\Scripts\activate.bat
+
+Then, install Helium using `pip`:
+
+.. code-block:: bash
+
+    python -m pip install helium
+
+Now enter :code:`python` into the command prompt and the command :code:`from
+helium import *` and you are ready to get started!

docs/index.rst

@@ -1,10 +1,40 @@
 Welcome to Helium's documentation!
 ==================================
 
+What is Helium?
+^^^^^^^^^^^^^^^
+
+Selenium-python but lighter
+
+`Selenium-python <https://selenium-python.readthedocs.io/>`_  is great for web
+automation. Helium makes it easier to use.
+
+Under the hood, Helium forwards each call to Selenium. The difference is that
+Helium's API is much more high-level. In Selenium, you need to use HTML IDs,
+XPaths and CSS selectors to identify web page elements. Helium on the other hand
+lets you refer to elements by user-visible labels. As a result, Helium scripts
+are typically 30-50% shorter than similar Selenium scripts. What's more, they
+are easier to read and more stable with respect to changes in the underlying web
+page.
+
+Because Helium is simply a wrapper around Selenium, you can freely mix the two
+libraries. For example:
+
+
+.. code-block:: python
+
+   # A Helium function:
+   driver = start_chrome()
+   # A Selenium API:
+   driver.execute_script("alert('Hi!');")
+
+So in other words, you don't lose anything by using Helium over pure Selenium.
+
 .. toctree::
    :maxdepth: 2
    :caption: Contents:
 
+   getting-started.rst
    main.rst
    contributors.rst