Move documentation from Wiki to a docs folder in the project repo

[bittner]

As of today, the documentation is in the repository's Wiki. It should be moved to a docs folder in the project repository and converted to reStructuredText. This way pull requests can include changes to the documentation that reflect the changes made to the source code.

Things to do afterwards:

• Move some docstrings from the source to the documentation (e.g. from get_url) to make sure there is only one place to update the description of the current behavior
• Script and/or automate the generation of the docs
• Upload the generated documentation to pythonhosted.org (PyPI) or readthedocs.org
• Update README and setup.py to make sure the PyPI package reflects the new location of the docs
• Maybe add a hint or redirect on the Wiki to tell visitors where the former docs have gone

[nikolas]

I agree! It would be great to get this documentation into the docs/ dir and up on readthedocs.org. Then I could submit pull requests for the documentation. For example, I'd like to add a note about how to integrate splinter with behave-django. The current getting started page on the wiki mentions this but doesn't go into depth.

[mixxorz]

When I started this project, I thought I'd be easier to just use the Wiki. But I guess using Sphinx or readthedocs would be better. I've never tried it before though. :stuck_out_tongue:

[mixxorz]

This is implemented by #20. Docs are now at pythonhosted.org