I've been more focused on getting the library working, and leaving little time to think about how to word documentation for human use. This issue is here to remind me this needs to happen before I hit the alpha release