Improved the  documentation to include an example.

Using the template to write a better version.