Updating README
Merge pull request #19 from martinthomson/readmelink

Updating README
Cleaning up candidate IDL and providing descriptions.
Fixing example.
Merge pull request #20 from martinthomson/candidates

Cleaning up candidate IDL and providing descriptions.