DOC: added and corrected documentation