[WIP] Add Sphinx doc configuration and Makefile and enhanced docstrings

This change mainly adds code examples to many methods, heavily borrowed from current tests.

For reviewers: you may want to run `make html` in `w3lib/docs` to see what you get