update large parts of the documentation and add a new section to streamline information about functions