* Document how to build the doumentation with sphinx
For convinience, I added a Makefile which spares one to memorize the
long sphinx command, or type python setup.py build_sphinx
You simply use `make html` and you will get the docs.
* Render README with markdown properly
conf.py includes some code to work around a bug in
common mark. The markdown is now properly converted to HTML.
* Fix rendering of CONTRIBUTING.md
Port a bunch of tests from python-k8sclient repository. There
is a script that starts a real instance of kubernetes and
the tests are executed against it.
Note, if you just have k8s accessible in your localhost:8080, the
tests still run. so you don't really need to run "py27-functional"
which runs the kube-init.sh
Also, 2 API calls fail currently, i've added a TODO so we can
dig into them and fix them
