WIP: Update docs

Updated the `docs` folder to be a pretty complete set of documentation.

The Old->New API document is now complete.

Waiting on docstrings to be done, then we'll merge this in.