* first draft * finish first draft * feedback and remove sections from API pages * clean docstrings * add full code example