Seperate README and getting started files due to links in README

Author: Birgit Schachler

README.rst

@@ -4,7 +4,7 @@ Introduction
 The windpowerlib is a library that provides a set of functions and classes to calculate the power output of wind turbines. It was originally part of the 
 `feedinlib <https://github.com/oemof/feedinlib>`_ (windpower and pv) but was taken out to build up a community concentrating on wind power models.
 
-For a quick start see the :ref:`examplereference-label` section.
+For a quick start see the `'Examples and basic usage' <http://windpowerlib.readthedocs.io/en/latest/getting_started.html#examplereference-label>`_ section.
 
 
 Documentation
@@ -31,7 +31,7 @@ Please see the `installation page <http://oemof.readthedocs.io/en/stable/install
 Optional Packages
 ~~~~~~~~~~~~~~~~~
 
-To see the plots of the windpowerlib example in the :ref:`examplereference-label` section you should `install the matplotlib package <http://matplotlib.org/users/installing.html>`_.
+To see the plots of the windpowerlib example in the `'Examples and basic usage' <http://windpowerlib.readthedocs.io/en/latest/getting_started.html#examplereference-label>`_ section you should `install the matplotlib package <http://matplotlib.org/users/installing.html>`_.
 Matplotlib can be installed using pip3 though some Linux users reported that it is easier and more stable to use the pre-built packages of your Linux distribution.
 
 
@@ -40,11 +40,12 @@ Matplotlib can be installed using pip3 though some Linux users reported that it
 Examples and basic usage
 =========================
 
-The basic usage of the windpowerlib is shown :ref:`here <basic_example_notebook.ipynb>`. The presented example is available as jupyter notebook and python script. You can download them along with example weather data:
+The basic usage of the windpowerlib is shown `'here' <http://windpowerlib.readthedocs.io/en/latest/basic_example_notebook.html>`_. The presented example is available as jupyter notebook and python script. You can download them along with example weather data:
+
+ * `'Python script' <https://raw.githubusercontent.com/wind-python/windpowerlib/dev/example/basic_example.py>`_
+ * `'Jupyter notebook' <https://raw.githubusercontent.com/wind-python/windpowerlib/features/revise_example/example/basic_example.ipynb>`_
+ * `'Example data file' <https://raw.githubusercontent.com/wind-python/windpowerlib/dev/example/weather.csv>`_
 
- * :download:`Python script <../example/basic_example.py>`
- * :download:`Jupyter notebook <../example/basic_example.ipynb>`
- * :download:`Example data file <../example/weather.csv>`
 
 To run the examples you first have to install the windpowerlib. To run the notebook you also need to install notebook using pip3. To launch jupyter notebook type ``jupyter notebook`` in terminal.
 This will open a browser window. Navigate to the directory containing the notebook to open it. See the jupyter notebook quick start guide for more information on `how to install <http://jupyter-notebook-beginner-guide.readthedocs.io/en/latest/install.html>`_ and

doc/getting_started.rst

@@ -2,4 +2,83 @@
 Getting started
 ~~~~~~~~~~~~~~~~~~~~~~
 
-.. include:: ../README.rst
+Introduction
+=============
+
+The windpowerlib is a library that provides a set of functions and classes to calculate the power output of wind turbines. It was originally part of the 
+`feedinlib <https://github.com/oemof/feedinlib>`_ (windpower and pv) but was taken out to build up a community concentrating on wind power models.
+
+For a quick start see the :ref:`examplereference-label` section.
+
+
+Documentation
+==============
+
+Full documentation can be found at `readthedocs <http://windpowerlib.readthedocs.org>`_.
+
+Use the `project site <http://readthedocs.org/projects/windpowerlib>`_ of readthedocs to choose the version of the documentation. 
+Go to the `download page <http://readthedocs.org/projects/windpowerlib/downloads/>`_ to download different versions and formats (pdf, html, epub) of the documentation.
+
+
+Installation
+============
+
+If you have a working Python3 environment, use pypi to install the latest windpowerlib version.
+
+::
+
+    pip3 install windpowerlib
+
+So far, the windpowerlib is mainly tested on python 3.4 but seems to work down to 2.7. 
+Please see the `installation page <http://oemof.readthedocs.io/en/stable/installation_and_setup.html>`_ of the oemof documentation for complete instructions on how to install python on your operating system.
+
+Optional Packages
+~~~~~~~~~~~~~~~~~
+
+To see the plots of the windpowerlib example in the :ref:`examplereference-label` section you should `install the matplotlib package <http://matplotlib.org/users/installing.html>`_.
+Matplotlib can be installed using pip3 though some Linux users reported that it is easier and more stable to use the pre-built packages of your Linux distribution.
+
+
+.. _examplereference-label:
+
+Examples and basic usage
+=========================
+
+The basic usage of the windpowerlib is shown :ref:`here <basic_example_notebook.ipynb>`. The presented example is available as jupyter notebook and python script. You can download them along with example weather data:
+
+ * :download:`Python script <../example/basic_example.py>`
+ * :download:`Jupyter notebook <../example/basic_example.ipynb>`
+ * :download:`Example data file <../example/weather.csv>`
+
+To run the examples you first have to install the windpowerlib. To run the notebook you also need to install notebook using pip3. To launch jupyter notebook type ``jupyter notebook`` in terminal.
+This will open a browser window. Navigate to the directory containing the notebook to open it. See the jupyter notebook quick start guide for more information on `how to install <http://jupyter-notebook-beginner-guide.readthedocs.io/en/latest/install.html>`_ and
+`how to run <http://jupyter-notebook-beginner-guide.readthedocs.io/en/latest/execute.html>`_ jupyter notebooks.
+
+
+Contributing
+==============
+
+Clone/Fork: https://github.com/wind-python/windpowerlib
+
+If you are interested in wind models and want to help improve the existing model do not hesitate to contact us.
+As the windpowerlib started with contributors from the `oemof developer group <https://github.com/orgs/oemof/teams/oemof-developer-group>`_ we use the same 
+`developer rules <http://oemof.readthedocs.io/en/stable/developing_oemof.html>`_.
+
+
+License
+============
+
+Copyright (C) 2017 oemof developing group
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program.  If not, see http://www.gnu.org/licenses/.