The README is getting very long. We may want to consider pulling the WORKSPACE and bzlmod instructions into separate files under the docs folder.

rules_go is doing this here https://github.com/bazelbuild/rules_go/blob/master/docs/go/core/bzlmod.md

The examples are getting quite complex for testing purposes, so having a first-time user dig through the examples is probably not best. We would refer to the examples as more advanced usage.