Improve documentation format #41
Description
As the library is growing, using README.md for documenting the API is becoming impractical.
Using Github Pages, or at the very least splitting the documentation by module would make it easier to consume. However, it would be good to keep documentation part of the code base so that it's versioned and tag along with the code.