starting documentation
layout of docs and docstring tweaks