fleshed out docs

Added a documentation for all the different functions and caveats.