Up-to-date'ing documentation

Documentation updated. Now it's possible (i hope) to compile zsphinx using `README.md`.