Update 'How it works' section.
Add testing info to README.
Fix broken links.
Update spec directory to work on gh-pages.
Add API section.
Update the README text. Closes #8.