We finally have docs automation for the new site! 🎉 So (when this rolled out), as part of the existing release automation, the docs should automagically be updated (via PR, although if we build enough confidence we could bypass that). It: • Generates the reference docs using the released Pants off-the-shelf (e.g. not from the Pants or docs repos) ◦

PANTS_VERSION="2.18.2rc0" pants help-all > help-all.json

• Copies the

docs/

from the pants repo (at the release commit) over the existing docs • Makes a PR with the changes