* Fix broken links to the documentation in the `README.md`.
* Adjust the package description in the `pubspec.yaml` file to
  appease pub.dev's scoring system.
* Move the example showing the configuration syntax from the
  `README.md` file to a separate `example/example.md` file.