Add optional 'title' attribute to the examples

Add a title attribute to the examples and show it as a comment above the example when present. Also updated the Readme to reflect the update.