A start on API docs

Really shows where we are lacking docstrings (mostly everywhere!).