change _generated -> api in Makefile
fix missing method keyword in functions
Improve doc formatting, add note about axis ordering
use a template for similar docstrings
Fix up some more backticks
remove note; one more backticks
Merge pull request #32 from kbarbary/doc-improvements

Doc Improvements