FYI the Plugin Upgrade Guide has now been updated to Pants 2.8 and the plugin docs shouldn't be stale anymore. Apologies that that got so out of date!
https://www.pantsbuild.org/docs/plugin-upgrade-guide
I'm also really hoping to rewrite the example-plugin repo in 2022 to be easier to follow and have more examples