Api docs refactor

@cpatrick This depends on the merge of #103, that's why it looks so huge :tomato: