Update/documentation#13

Closes #13 

Improves API section of docs for (hopefully) better clarity and detail