Update documentation to use the new expectation syntax.

This is the first commit towards updating the documentation. I will move to rdocs next but I wanted to start a pull request so that folks can give feedback or tell me if I missed certain places.