update the docs to make them more readable
improved docs