(PDOC-13) Update README with examples and resources

In order to make it easier for users, give some basic examples
in the README of how write documentation that is compatible with
strings. Also provide a few resources for getting started.
are the { } around the text "example" intentional? Looks like a bug...