refactored the docs and written a bit more of them