Is a manual update to https://github.com/pantsbuild/pants/blob/master/examples/src/java/org/pantsbuild/example/README.md the right way to update the docs? Happy to send a PR.