documentation improvements

Author: csparpa

README.md

@@ -96,9 +96,9 @@ _YaST/Zypper (OpenSuse)_ (please refer to the documentation for more detail)
 Eager to fetch the very latest updates to PyOWM? Install the development trunk (which might be unstable). Eg on Linux:
 
 ```shell
-git clone https://github.com/csparpa/pyowm.git
-cd pyowm && git checkout develop
-pip install -r requirements.txt && python setup.py install
+$ git clone https://github.com/csparpa/pyowm.git
+$ cd pyowm && git checkout develop
+$ pip install -r requirements.txt && python setup.py install
 ```
 
 ## Documentation

readthedocs.yml

@@ -1,4 +1,4 @@
 python:
-   version: 3.5
+   version: 3.7
 
 requirements_file: dev-requirements.txt

sphinx/index.rst

@@ -87,8 +87,8 @@ Usage and Technical Documentation
 PyOWM v3 documentation
 ~~~~~~~~~~~~~~~~~~~~~~
 
-Quick code recipes (work in progress)
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Quick code recipes
+^^^^^^^^^^^^^^^^^^
 .. toctree::
    :maxdepth: 1
 

sphinx/v3/faq.md

@@ -45,4 +45,43 @@ Please install PyOWM 2.10 with:
 pip2 install pyowm==2.10 
 ```
 
-And find the PyOWM 2.10 documentation [here](https://pyowm.readthedocs.io/en/2.10/)
+And find the PyOWM 2.10 documentation [here](https://pyowm.readthedocs.io/en/2.10/)
+
+
+## ModuleNotFound error upon installing PyOWM development branch from Github
+
+Installation of the (potentially unstable) development trunk used to be like this:
+
+```shell
+$ pip install git+https://github.com/csparpa/pyowm.git@develop
+```
+
+You would get something like:
+
+```shell
+Collecting git+https://github.com/csparpa/pyowm.git@develop
+  Cloning https://github.com/csparpa/pyowm.git (to revision develop) to /tmp/pip-req-build-_86bl7ty
+    [......]
+    ERROR: Command errored out with exit status 1:
+     command: /home/me/.local/share/virtualenvs/backend-nPPHZqlJ/bin/python -c 'import sys, setuptools, tokenize; sys.argv[0] = '"'"'/tmp/pip-req-build-_86bl7ty/setup.py'"'"'; __file__='"'"'/tmp/pip-req-build-_86bl7ty/setup.py'"'"';f=getattr(tokenize, '"'"'open'"'"', open)(__file__);code=f.read().replace('"'"'\r\n'"'"', '"'"'\n'"'"');f.close();exec(compile(code, __file__, '"'"'exec'"'"'))' egg_info --egg-base /tmp/pip-pip-egg-info-ww_gs9y3
+         cwd: /tmp/pip-req-build-_86bl7ty/
+    Complete output (17 lines):
+    Traceback (most recent call last):
+      [......]
+      File "/tmp/pip-req-build-_86bl7ty/pyowm/commons/tile.py", line 6, in <module>
+        from pyowm.utils.geo import Polygon
+      File "/tmp/pip-req-build-_86bl7ty/pyowm/utils/geo.py", line 4, in <module>
+        import geojson
+    ModuleNotFoundError: No module named 'geojson'
+    ----------------------------------------
+ERROR: Command errored out with exit status 1: python setup.py egg_info Check the logs for full command output.
+```
+
+I've realized this way of installing is bad *as it does not install PyOWM's dependencies** along.
+Therefore the right way to go is:
+
+```shell
+$ git clone https://github.com/csparpa/pyowm.git
+$ cd pyowm && git checkout develop
+$ pip install -r requirements.txt && python setup.py install
+```