Merge pull request #56 from lencioni/documentation

Improve some formatting
Add screencast
Tweak README
Tweak README again
Remove image
minor type in error message
minor typo in module description
Merge pull request #57 from dguzzo/patch-1

minor typo fixes
Reformat YARD in Palette

This commit simply re-wraps the lines at 80 characters and moves the
variable names for the @param tags before the datatypes.