Changing docs to reflect on recent API change
change docs example imports
restructuring list on front page
bit more reorganizing
Merge pull request #96 from bsipocz/aper_fix_docs

Changing docs to reflect on recent API change