add docstrings to API

docstrings will be our documentation. This is better
than a separate file, as it does not need to be edited separately
from the code.