Update readme

Switch to GitHub flavored markdown for the examples. Point to the
include file for documentaion. Add Travis CI build status image.