Check in help-all.json for posterity (#43)

This changed fixes
#29 by:
- Checking in the `help-all.json` for every version, under the
`reference` directory
- Adjust the sync docs CI and generation scripts to handle this change

---

<details>
<summary>Script to generate these versions</summary>

(Note `/home/josh/work/scie-pants/dist/scie-pants-linux-x86_64` contains
a temporary fix for pantsbuild/scie-pants#321)

```bash
#!/bin/bash -x
set -e

HERE=$PWD
cd $(mktemp -d)
touch pants.toml
touch BUILDROOT

# @todo: The Pants launcher dies pre 2.8: pantsbuild/scie-pants#321

export PANTS_NO_VERIFY_CONFIG=true
export PANTS_BACKEND_PACKAGES=[]

PANTS_VERSION=2.0.2 /home/josh/work/scie-pants/dist/scie-pants-linux-x86_64 \
    --backend-packages='[ \
        "pants.backend.python", \
        "pants.backend.python.lint.black", \
        "pants.backend.python.lint.docformatter", \
        "pants.backend.python.lint.flake8", \
        "pants.backend.python.lint.isort", \
        "pants.backend.python.typecheck.mypy", \
        "pants.backend.python.lint.bandit", \
        "pants.backend.python.lint.pylint", \
        "pants.backend.codegen.protobuf.python", \
        "pants.backend.awslambda.python"\
    ]' \
    help-all > "$HERE/2.0.x.help-all.json"

PANTS_VERSION=2.1.2 /home/josh/work/scie-pants/dist/scie-pants-linux-x86_64 \
    --backend-packages='[ \
        "pants.backend.python", \
        "pants.backend.python.lint.black", \
        "pants.backend.python.lint.docformatter", \
        "pants.backend.python.lint.flake8", \
        "pants.backend.python.lint.isort", \
        "pants.backend.python.typecheck.mypy", \
        "pants.backend.python.lint.bandit", \
        "pants.backend.python.lint.pylint", \
        "pants.backend.codegen.protobuf.python", \
        "pants.backend.awslambda.python"\
    ]' \
    help-all > "$HERE/2.1.x.help-all.json"

PANTS_VERSION=2.2.4 /home/josh/work/scie-pants/dist/scie-pants-linux-x86_64 \
    --backend-packages='[ \
        "pants.backend.awslambda.python", \
        "pants.backend.python", \
        "pants.backend.codegen.protobuf.python", \
        "pants.backend.python.lint.black", \
        "pants.backend.python.lint.docformatter", \
        "pants.backend.python.lint.flake8", \
        "pants.backend.python.lint.isort", \
        "pants.backend.python.typecheck.mypy", \
        "pants.backend.python.mixed_interpreter_constraints", \
        "pants.backend.python.lint.bandit", \
        "pants.backend.python.lint.pylint", \
    ]' \
    help-all > "$HERE/2.2.x.help-all.json"

PANTS_VERSION=2.3.3 /home/josh/work/scie-pants/dist/scie-pants-linux-x86_64 \
    --backend-packages='[ \
        "pants.backend.awslambda.python", \
        "pants.backend.python", \
        "pants.backend.codegen.protobuf.python", \
        "pants.backend.python.lint.black", \
        "pants.backend.python.lint.docformatter", \
        "pants.backend.python.lint.flake8", \
        "pants.backend.python.lint.isort", \
        "pants.backend.python.typecheck.mypy", \
        "pants.backend.python.mixed_interpreter_constraints", \
        "pants.backend.python.lint.bandit", \
        "pants.backend.python.lint.pylint", \
    ]' \
    help-all > "$HERE/2.3.x.help-all.json"

PANTS_VERSION=2.4.2 /home/josh/work/scie-pants/dist/scie-pants-linux-x86_64 \
    --backend-packages='[ \
        "pants.backend.awslambda.python", \
        "pants.backend.python", \
        "pants.backend.codegen.protobuf.python", \
        "pants.backend.python.lint.black", \
        "pants.backend.python.lint.docformatter", \
        "pants.backend.python.lint.flake8", \
        "pants.backend.python.lint.isort", \
        "pants.backend.python.typecheck.mypy", \
        "pants.backend.python.mixed_interpreter_constraints", \
        "pants.backend.python.lint.bandit", \
        "pants.backend.python.lint.pylint", \
    ]' \
    help-all > "$HERE/2.4.x.help-all.json"

PANTS_VERSION=2.5.2 /home/josh/work/scie-pants/dist/scie-pants-linux-x86_64 \
    --backend-packages='[ \
        "pants.backend.awslambda.python", \
        "pants.backend.python", \
        "pants.backend.codegen.protobuf.python", \
        "pants.backend.python.lint.black", \
        "pants.backend.python.lint.docformatter", \
        "pants.backend.python.lint.flake8", \
        "pants.backend.python.lint.isort", \
        "pants.backend.python.typecheck.mypy", \
        "pants.backend.python.mixed_interpreter_constraints", \
        "pants.backend.shell", \
        "pants.backend.shell.lint.shellcheck", \
        "pants.backend.shell.lint.shfmt", \
        "pants.backend.python.lint.bandit", \
        "pants.backend.python.lint.pylint", \
    ]' \
    help-all > "$HERE/2.5.x.help-all.json"

PANTS_VERSION=2.6.1 /home/josh/work/scie-pants/dist/scie-pants-linux-x86_64 \
    --backend-packages='[ \
        "pants.backend.awslambda.python", \
        "pants.backend.python", \
        "pants.backend.codegen.protobuf.python", \
        "pants.backend.python.lint.black", \
        "pants.backend.python.lint.docformatter", \
        "pants.backend.python.lint.flake8", \
        "pants.backend.python.lint.isort", \
        "pants.backend.python.typecheck.mypy", \
        "pants.backend.python.mixed_interpreter_constraints", \
        "pants.backend.shell", \
        "pants.backend.shell.lint.shellcheck", \
        "pants.backend.shell.lint.shfmt", \
        "pants.backend.python.lint.bandit", \
        "pants.backend.python.lint.pylint", \
    ]' \
    help-all > "$HERE/2.6.x.help-all.json"

PANTS_VERSION=2.7.2 /home/josh/work/scie-pants/dist/scie-pants-linux-x86_64 \
    --backend-packages='[ \
        "pants.backend.python", \
        "pants.backend.python.lint.black", \
        "pants.backend.python.lint.docformatter", \
        "pants.backend.python.lint.flake8", \
        "pants.backend.python.lint.isort", \
        "pants.backend.python.typecheck.mypy", \
        "pants.backend.python.mixed_interpreter_constraints", \
        "pants.backend.shell", \
        "pants.backend.shell.lint.shellcheck", \
        "pants.backend.shell.lint.shfmt", \
        "pants.backend.experimental.python", \
        "pants.backend.experimental.docker", \
        "pants.backend.codegen.protobuf.python", \
        "pants.backend.awslambda.python", \
        "pants.backend.python.lint.bandit", \
        "pants.backend.python.lint.pylint", \
        "pants.backend.python.lint.yapf", \
    ]' \
    help-all > "$HERE/2.7.x.help-all.json"

PANTS_VERSION=2.8.1 /home/josh/work/scie-pants/dist/scie-pants-linux-x86_64 \
    --backend-packages='[ \
        "pants.backend.python", \
        "pants.backend.experimental.python.lint.autoflake", \
        "pants.backend.python.lint.black", \
        "pants.backend.python.lint.docformatter", \
        "pants.backend.python.lint.flake8", \
        "pants.backend.python.lint.isort", \
        "pants.backend.python.typecheck.mypy", \
        "pants.backend.python.mixed_interpreter_constraints", \
        "pants.backend.shell", \
        "pants.backend.shell.lint.shellcheck", \
        "pants.backend.shell.lint.shfmt", \
        "pants.backend.experimental.docker", \
        "pants.backend.experimental.go", \
        "pants.backend.experimental.java", \
        "pants.backend.experimental.java.debug_goals", \
        "pants.backend.experimental.python", \
        "pants.backend.experimental.python.lint.pyupgrade", \
        "pants.backend.codegen.protobuf.python", \
        "pants.backend.awslambda.python", \
        "pants.backend.python.lint.bandit", \
        "pants.backend.python.lint.pylint", \
        "pants.backend.python.lint.yapf", \
    ]' \
    help-all > "$HERE/2.8.x.help-all.json"

PANTS_VERSION=2.9.2 /home/josh/work/scie-pants/dist/scie-pants-linux-x86_64 \
    --backend-packages='[ \
        "pants.backend.awslambda.python", \
        "pants.backend.codegen.protobuf.python", \
        "pants.backend.experimental.docker", \
        "pants.backend.experimental.docker.lint.hadolint", \
        "pants.backend.experimental.go", \
        "pants.backend.experimental.java", \
        "pants.backend.experimental.java.lint.google_java_format", \
        "pants.backend.experimental.python", \
        "pants.backend.experimental.python.lint.autoflake", \
        "pants.backend.experimental.python.lint.pyupgrade", \
        "pants.backend.experimental.scala", \
        "pants.backend.experimental.scala.lint.scalafmt", \
        "pants.backend.google_cloud_function.python", \
        "pants.backend.plugin_development", \
        "pants.backend.python", \
        "pants.backend.python.lint.bandit", \
        "pants.backend.python.lint.black", \
        "pants.backend.python.lint.docformatter", \
        "pants.backend.python.lint.flake8", \
        "pants.backend.python.lint.isort", \
        "pants.backend.python.lint.pylint", \
        "pants.backend.python.lint.yapf", \
        "pants.backend.python.mixed_interpreter_constraints", \
        "pants.backend.python.typecheck.mypy", \
        "pants.backend.shell", \
        "pants.backend.shell.lint.shellcheck", \
        "pants.backend.shell.lint.shfmt", \
    ]' \
    help-all > "$HERE/2.9.x.help-all.json"

PANTS_VERSION=2.10.1 /home/josh/work/scie-pants/dist/scie-pants-linux-x86_64 \
    --backend-packages='[ \
        "pants.backend.awslambda.python", \
        "pants.backend.codegen.protobuf.python", \
        "pants.backend.codegen.thrift.apache.python", \
        "pants.backend.docker", \
        "pants.backend.docker.lint.hadolint", \
        "pants.backend.experimental.go", \
        "pants.backend.experimental.java", \
        "pants.backend.experimental.java.lint.google_java_format", \
        "pants.backend.experimental.python", \
        "pants.backend.experimental.python.lint.autoflake", \
        "pants.backend.experimental.python.lint.pyupgrade", \
        "pants.backend.experimental.python.packaging.pyoxidizer", \
        "pants.backend.experimental.scala", \
        "pants.backend.experimental.scala.lint.scalafmt", \
        "pants.backend.google_cloud_function.python", \
        "pants.backend.plugin_development", \
        "pants.backend.python", \
        "pants.backend.python.lint.bandit", \
        "pants.backend.python.lint.black", \
        "pants.backend.python.lint.docformatter", \
        "pants.backend.python.lint.flake8", \
        "pants.backend.python.lint.isort", \
        "pants.backend.python.lint.pylint", \
        "pants.backend.python.lint.yapf", \
        "pants.backend.python.mixed_interpreter_constraints", \
        "pants.backend.python.typecheck.mypy", \
        "pants.backend.shell", \
        "pants.backend.shell.lint.shellcheck", \
        "pants.backend.shell.lint.shfmt", \
    ]' \
    help-all > "$HERE/2.10.x.help-all.json"

PANTS_VERSION=2.11.1 /home/josh/work/scie-pants/dist/scie-pants-linux-x86_64 \
    --backend-packages='[ \
        "pants.backend.awslambda.python", \
        "pants.backend.codegen.protobuf.lint.buf", \
        "pants.backend.codegen.protobuf.python", \
        "pants.backend.codegen.thrift.apache.python", \
        "pants.backend.docker", \
        "pants.backend.docker.lint.hadolint", \
        "pants.backend.experimental.codegen.protobuf.go", \
        "pants.backend.experimental.codegen.protobuf.java", \
        "pants.backend.experimental.codegen.protobuf.scala", \
        "pants.backend.experimental.go", \
        "pants.backend.experimental.helm", \
        "pants.backend.experimental.java", \
        "pants.backend.experimental.java.lint.google_java_format", \
        "pants.backend.experimental.python", \
        "pants.backend.experimental.python.lint.autoflake", \
        "pants.backend.experimental.python.lint.pyupgrade", \
        "pants.backend.experimental.python.packaging.pyoxidizer", \
        "pants.backend.experimental.scala", \
        "pants.backend.experimental.scala.lint.scalafmt", \
        "pants.backend.experimental.terraform", \
        "pants.backend.google_cloud_function.python", \
        "pants.backend.plugin_development", \
        "pants.backend.python", \
        "pants.backend.python.lint.bandit", \
        "pants.backend.python.lint.black", \
        "pants.backend.python.lint.docformatter", \
        "pants.backend.python.lint.flake8", \
        "pants.backend.python.lint.isort", \
        "pants.backend.python.lint.pylint", \
        "pants.backend.python.lint.yapf", \
        "pants.backend.python.mixed_interpreter_constraints", \
        "pants.backend.python.typecheck.mypy", \
        "pants.backend.shell", \
        "pants.backend.shell.lint.shellcheck", \
        "pants.backend.shell.lint.shfmt", \
    ]' \
    help-all > "$HERE/2.11.x.help-all.json"

PANTS_VERSION=2.12.1 /home/josh/work/scie-pants/dist/scie-pants-linux-x86_64 \
    --backend-packages='[ \
        "pants.backend.awslambda.python", \
        "pants.backend.codegen.protobuf.lint.buf", \
        "pants.backend.codegen.protobuf.python", \
        "pants.backend.codegen.thrift.apache.python", \
        "pants.backend.docker", \
        "pants.backend.docker.lint.hadolint", \
        "pants.backend.experimental.codegen.protobuf.go", \
        "pants.backend.experimental.codegen.protobuf.java", \
        "pants.backend.experimental.codegen.protobuf.scala", \
        "pants.backend.experimental.go", \
        "pants.backend.experimental.helm", \
        "pants.backend.experimental.java", \
        "pants.backend.experimental.java.lint.google_java_format", \
        "pants.backend.experimental.kotlin", \
        "pants.backend.experimental.kotlin.lint.ktlint", \
        "pants.backend.experimental.python", \
        "pants.backend.experimental.python.lint.autoflake", \
        "pants.backend.experimental.python.lint.pyupgrade", \
        "pants.backend.experimental.python.packaging.pyoxidizer", \
        "pants.backend.experimental.scala", \
        "pants.backend.experimental.scala.lint.scalafmt", \
        "pants.backend.experimental.terraform", \
        "pants.backend.google_cloud_function.python", \
        "pants.backend.plugin_development", \
        "pants.backend.python", \
        "pants.backend.python.lint.bandit", \
        "pants.backend.python.lint.black", \
        "pants.backend.python.lint.docformatter", \
        "pants.backend.python.lint.flake8", \
        "pants.backend.python.lint.isort", \
        "pants.backend.python.lint.pylint", \
        "pants.backend.python.lint.yapf", \
        "pants.backend.python.mixed_interpreter_constraints", \
        "pants.backend.python.typecheck.mypy", \
        "pants.backend.shell", \
        "pants.backend.shell.lint.shellcheck", \
        "pants.backend.shell.lint.shfmt", \
    ]' \
    help-all > "$HERE/2.12.x.help-all.json"

PANTS_VERSION=2.13.1 /home/josh/work/scie-pants/dist/scie-pants-linux-x86_64 \
    --backend-packages='[ \
        "pants.backend.awslambda.python", \
        "pants.backend.codegen.protobuf.lint.buf", \
        "pants.backend.codegen.protobuf.python", \
        "pants.backend.codegen.thrift.apache.python", \
        "pants.backend.docker", \
        "pants.backend.docker.lint.hadolint", \
        "pants.backend.experimental.codegen.protobuf.go", \
        "pants.backend.experimental.codegen.protobuf.java", \
        "pants.backend.experimental.codegen.protobuf.scala", \
        "pants.backend.experimental.go", \
        "pants.backend.experimental.helm", \
        "pants.backend.experimental.java", \
        "pants.backend.experimental.java.lint.google_java_format", \
        "pants.backend.experimental.kotlin", \
        "pants.backend.experimental.kotlin.lint.ktlint", \
        "pants.backend.experimental.python", \
        "pants.backend.experimental.python.lint.autoflake", \
        "pants.backend.experimental.python.lint.pyupgrade", \
        "pants.backend.experimental.python.packaging.pyoxidizer", \
        "pants.backend.experimental.scala", \
        "pants.backend.experimental.scala.lint.scalafmt", \
        "pants.backend.experimental.terraform", \
        "pants.backend.google_cloud_function.python", \
        "pants.backend.plugin_development", \
        "pants.backend.python", \
        "pants.backend.python.lint.bandit", \
        "pants.backend.python.lint.black", \
        "pants.backend.python.lint.docformatter", \
        "pants.backend.python.lint.flake8", \
        "pants.backend.python.lint.isort", \
        "pants.backend.python.lint.pylint", \
        "pants.backend.python.lint.yapf", \
        "pants.backend.python.mixed_interpreter_constraints", \
        "pants.backend.python.typecheck.mypy", \
        "pants.backend.shell", \
        "pants.backend.shell.lint.shellcheck", \
        "pants.backend.shell.lint.shfmt", \
    ]' \
    help-all > "$HERE/2.13.x.help-all.json"

PANTS_VERSION=2.14.2 /home/josh/work/scie-pants/dist/scie-pants-linux-x86_64 \
    --backend-packages='[ \
        "pants.backend.build_files.fmt.black", \
        "pants.backend.build_files.fmt.buildifier", \
        "pants.backend.build_files.fmt.yapf", \
        "pants.backend.awslambda.python", \
        "pants.backend.codegen.protobuf.lint.buf", \
        "pants.backend.codegen.protobuf.python", \
        "pants.backend.codegen.thrift.apache.python", \
        "pants.backend.docker", \
        "pants.backend.docker.lint.hadolint", \
        "pants.backend.experimental.codegen.protobuf.go", \
        "pants.backend.experimental.codegen.protobuf.java", \
        "pants.backend.experimental.codegen.protobuf.scala", \
        "pants.backend.experimental.go", \
        "pants.backend.experimental.helm", \
        "pants.backend.experimental.java", \
        "pants.backend.experimental.java.lint.google_java_format", \
        "pants.backend.experimental.kotlin", \
        "pants.backend.experimental.kotlin.lint.ktlint", \
        "pants.backend.experimental.python", \
        "pants.backend.experimental.python.lint.autoflake", \
        "pants.backend.experimental.python.lint.pyupgrade", \
        "pants.backend.experimental.python.packaging.pyoxidizer", \
        "pants.backend.experimental.scala", \
        "pants.backend.experimental.scala.lint.scalafmt", \
        "pants.backend.experimental.terraform", \
        "pants.backend.google_cloud_function.python", \
        "pants.backend.plugin_development", \
        "pants.backend.python", \
        "pants.backend.python.lint.bandit", \
        "pants.backend.python.lint.black", \
        "pants.backend.python.lint.docformatter", \
        "pants.backend.python.lint.flake8", \
        "pants.backend.python.lint.isort", \
        "pants.backend.python.lint.pylint", \
        "pants.backend.python.lint.yapf", \
        "pants.backend.python.mixed_interpreter_constraints", \
        "pants.backend.python.typecheck.mypy", \
        "pants.backend.shell", \
        "pants.backend.shell.lint.shellcheck", \
        "pants.backend.shell.lint.shfmt", \
    ]' \
    help-all > "$HERE/2.14.x.help-all.json"

PANTS_VERSION=2.15.2 /home/josh/work/scie-pants/dist/scie-pants-linux-x86_64 \
    --backend-packages='[ \
        "pants.backend.build_files.fix.deprecations", \
        "pants.backend.build_files.fmt.black", \
        "pants.backend.build_files.fmt.buildifier", \
        "pants.backend.build_files.fmt.yapf", \
        "pants.backend.awslambda.python", \
        "pants.backend.codegen.protobuf.lint.buf", \
        "pants.backend.codegen.protobuf.python", \
        "pants.backend.codegen.thrift.apache.python", \
        "pants.backend.docker", \
        "pants.backend.docker.lint.hadolint", \
        "pants.backend.experimental.codegen.protobuf.go", \
        "pants.backend.experimental.codegen.protobuf.java", \
        "pants.backend.experimental.codegen.protobuf.scala", \
        "pants.backend.experimental.go", \
        "pants.backend.experimental.helm", \
        "pants.backend.experimental.java", \
        "pants.backend.experimental.java.lint.google_java_format", \
        "pants.backend.experimental.kotlin", \
        "pants.backend.experimental.kotlin.lint.ktlint", \
        "pants.backend.experimental.openapi", \
        "pants.backend.experimental.openapi.lint.spectral", \
        "pants.backend.experimental.python", \
        "pants.backend.experimental.python.lint.add_trailing_comma", \
        "pants.backend.experimental.python.lint.autoflake", \
        "pants.backend.experimental.python.lint.pyupgrade", \
        "pants.backend.experimental.python.packaging.pyoxidizer", \
        "pants.backend.experimental.scala", \
        "pants.backend.experimental.scala.lint.scalafmt", \
        "pants.backend.experimental.terraform", \
        "pants.backend.google_cloud_function.python", \
        "pants.backend.plugin_development", \
        "pants.backend.python", \
        "pants.backend.python.lint.bandit", \
        "pants.backend.python.lint.black", \
        "pants.backend.python.lint.docformatter", \
        "pants.backend.python.lint.flake8", \
        "pants.backend.python.lint.isort", \
        "pants.backend.python.lint.pylint", \
        "pants.backend.python.lint.yapf", \
        "pants.backend.python.mixed_interpreter_constraints", \
        "pants.backend.python.typecheck.mypy", \
        "pants.backend.shell", \
        "pants.backend.shell.lint.shellcheck", \
        "pants.backend.shell.lint.shfmt", \
    ]' \
    help-all > "$HERE/2.15.x.help-all.json"

PANTS_VERSION=2.16.1rc4 /home/josh/work/scie-pants/dist/scie-pants-linux-x86_64 \
    --backend-packages='[ \
        "pants.backend.build_files.fix.deprecations", \
        "pants.backend.build_files.fmt.black", \
        "pants.backend.build_files.fmt.buildifier", \
        "pants.backend.build_files.fmt.yapf", \
        "pants.backend.awslambda.python", \
        "pants.backend.codegen.protobuf.lint.buf", \
        "pants.backend.codegen.protobuf.python", \
        "pants.backend.codegen.thrift.apache.python", \
        "pants.backend.docker", \
        "pants.backend.docker.lint.hadolint", \
        "pants.backend.experimental.adhoc", \
        "pants.backend.experimental.codegen.protobuf.go", \
        "pants.backend.experimental.codegen.protobuf.java", \
        "pants.backend.experimental.codegen.protobuf.scala", \
        "pants.backend.experimental.go", \
        "pants.backend.experimental.helm", \
        "pants.backend.experimental.java", \
        "pants.backend.experimental.java.lint.google_java_format", \
        "pants.backend.experimental.kotlin", \
        "pants.backend.experimental.kotlin.lint.ktlint", \
        "pants.backend.experimental.openapi", \
        "pants.backend.experimental.openapi.lint.spectral", \
        "pants.backend.experimental.python", \
        "pants.backend.experimental.python.framework.stevedore", \
        "pants.backend.experimental.python.lint.add_trailing_comma", \
        "pants.backend.experimental.python.lint.ruff", \
        "pants.backend.experimental.python.packaging.pyoxidizer", \
        "pants.backend.experimental.scala", \
        "pants.backend.experimental.scala.lint.scalafmt", \
        "pants.backend.experimental.terraform", \
        "pants.backend.experimental.tools.yamllint", \
        "pants.backend.google_cloud_function.python", \
        "pants.backend.plugin_development", \
        "pants.backend.python", \
        "pants.backend.python.lint.autoflake", \
        "pants.backend.python.lint.bandit", \
        "pants.backend.python.lint.black", \
        "pants.backend.python.lint.docformatter", \
        "pants.backend.python.lint.flake8", \
        "pants.backend.python.lint.isort", \
        "pants.backend.python.lint.pydocstyle", \
        "pants.backend.python.lint.pylint", \
        "pants.backend.python.lint.pyupgrade", \
        "pants.backend.python.lint.yapf", \
        "pants.backend.python.mixed_interpreter_constraints", \
        "pants.backend.python.typecheck.mypy", \
        "pants.backend.shell", \
        "pants.backend.shell.lint.shellcheck", \
        "pants.backend.shell.lint.shfmt", \
        "pants.backend.tools.preamble", \
    ]' \
    help-all > "$HERE/2.16.x.help-all.json"

PANTS_VERSION=2.17.1rc3 /home/josh/work/scie-pants/dist/scie-pants-linux-x86_64 \
    --backend-packages='[ \
        "pants.backend.build_files.fix.deprecations", \
        "pants.backend.build_files.fmt.black", \
        "pants.backend.build_files.fmt.buildifier", \
        "pants.backend.build_files.fmt.yapf", \
        "pants.backend.awslambda.python", \
        "pants.backend.codegen.protobuf.lint.buf", \
        "pants.backend.codegen.protobuf.python", \
        "pants.backend.codegen.thrift.apache.python", \
        "pants.backend.docker", \
        "pants.backend.docker.lint.hadolint", \
        "pants.backend.experimental.adhoc", \
        "pants.backend.experimental.codegen.protobuf.go", \
        "pants.backend.experimental.codegen.protobuf.java", \
        "pants.backend.experimental.codegen.protobuf.scala", \
        "pants.backend.experimental.go", \
        "pants.backend.experimental.helm", \
        "pants.backend.experimental.java", \
        "pants.backend.experimental.java.lint.google_java_format", \
        "pants.backend.experimental.kotlin", \
        "pants.backend.experimental.kotlin.lint.ktlint", \
        "pants.backend.experimental.openapi", \
        "pants.backend.experimental.openapi.lint.spectral", \
        "pants.backend.experimental.python", \
        "pants.backend.experimental.python.framework.stevedore", \
        "pants.backend.experimental.python.lint.add_trailing_comma", \
        "pants.backend.experimental.python.lint.ruff", \
        "pants.backend.experimental.python.packaging.pyoxidizer", \
        "pants.backend.experimental.scala", \
        "pants.backend.experimental.scala.lint.scalafmt", \
        "pants.backend.experimental.terraform", \
        "pants.backend.experimental.tools.workunit_logger", \
        "pants.backend.experimental.tools.yamllint", \
        "pants.backend.google_cloud_function.python", \
        "pants.backend.plugin_development", \
        "pants.backend.python", \
        "pants.backend.python.lint.autoflake", \
        "pants.backend.python.lint.bandit", \
        "pants.backend.python.lint.black", \
        "pants.backend.python.lint.docformatter", \
        "pants.backend.python.lint.flake8", \
        "pants.backend.python.lint.isort", \
        "pants.backend.python.lint.pydocstyle", \
        "pants.backend.python.lint.pylint", \
        "pants.backend.python.lint.pyupgrade", \
        "pants.backend.python.lint.yapf", \
        "pants.backend.python.mixed_interpreter_constraints", \
        "pants.backend.python.typecheck.mypy", \
        "pants.backend.shell", \
        "pants.backend.shell.lint.shellcheck", \
        "pants.backend.shell.lint.shfmt", \
        "pants.backend.tools.preamble", \
    ]' \
    help-all > "$HERE/2.17.x.help-all.json"

PANTS_VERSION=2.18.0rc5 /home/josh/work/scie-pants/dist/scie-pants-linux-x86_64 \
    --backend-packages='[ \
        "pants.backend.build_files.fix.deprecations", \
        "pants.backend.build_files.fmt.black", \
        "pants.backend.build_files.fmt.buildifier", \
        "pants.backend.build_files.fmt.yapf", \
        "pants.backend.awslambda.python", \
        "pants.backend.codegen.protobuf.lint.buf", \
        "pants.backend.codegen.protobuf.python", \
        "pants.backend.codegen.thrift.apache.python", \
        "pants.backend.docker", \
        "pants.backend.docker.lint.hadolint", \
        "pants.backend.experimental.adhoc", \
        "pants.backend.experimental.codegen.protobuf.go", \
        "pants.backend.experimental.codegen.protobuf.java", \
        "pants.backend.experimental.codegen.protobuf.scala", \
        "pants.backend.experimental.go", \
        "pants.backend.experimental.helm", \
        "pants.backend.experimental.java", \
        "pants.backend.experimental.java.lint.google_java_format", \
        "pants.backend.experimental.kotlin", \
        "pants.backend.experimental.kotlin.lint.ktlint", \
        "pants.backend.experimental.openapi", \
        "pants.backend.experimental.openapi.lint.spectral", \
        "pants.backend.experimental.python", \
        "pants.backend.experimental.python.framework.stevedore", \
        "pants.backend.experimental.python.lint.add_trailing_comma", \
        "pants.backend.experimental.python.lint.ruff", \
        "pants.backend.experimental.python.packaging.pyoxidizer", \
        "pants.backend.experimental.python.typecheck.pytype", \
        "pants.backend.experimental.scala", \
        "pants.backend.experimental.scala.lint.scalafmt", \
        "pants.backend.experimental.terraform", \
        "pants.backend.experimental.tools.workunit_logger", \
        "pants.backend.experimental.tools.yamllint", \
        "pants.backend.google_cloud_function.python", \
        "pants.backend.plugin_development", \
        "pants.backend.python", \
        "pants.backend.python.lint.autoflake", \
        "pants.backend.python.lint.bandit", \
        "pants.backend.python.lint.black", \
        "pants.backend.python.lint.docformatter", \
        "pants.backend.python.lint.flake8", \
        "pants.backend.python.lint.isort", \
        "pants.backend.python.lint.pydocstyle", \
        "pants.backend.python.lint.pylint", \
        "pants.backend.python.lint.pyupgrade", \
        "pants.backend.python.lint.yapf", \
        "pants.backend.python.mixed_interpreter_constraints", \
        "pants.backend.python.typecheck.mypy", \
        "pants.backend.shell", \
        "pants.backend.shell.lint.shellcheck", \
        "pants.backend.shell.lint.shfmt", \
        "pants.backend.tools.preamble", \
    ]' \
    help-all > "$HERE/2.18.x.help-all.json"


PANTS_VERSION=2.19.0rc1 /home/josh/work/scie-pants/dist/scie-pants-linux-x86_64 \
    --backend-packages='[ \
        "pants.backend.build_files.fix.deprecations", \
        "pants.backend.build_files.fmt.black", \
        "pants.backend.build_files.fmt.buildifier", \
        "pants.backend.build_files.fmt.yapf", \
        "pants.backend.awslambda.python", \
        "pants.backend.codegen.protobuf.lint.buf", \
        "pants.backend.codegen.protobuf.python", \
        "pants.backend.codegen.thrift.apache.python", \
        "pants.backend.docker", \
        "pants.backend.docker.lint.hadolint", \
        "pants.backend.experimental.adhoc", \
        "pants.backend.experimental.codegen.protobuf.go", \
        "pants.backend.experimental.codegen.protobuf.java", \
        "pants.backend.experimental.codegen.protobuf.scala", \
        "pants.backend.experimental.go", \
        "pants.backend.experimental.helm", \
        "pants.backend.experimental.java", \
        "pants.backend.experimental.java.lint.google_java_format", \
        "pants.backend.experimental.kotlin", \
        "pants.backend.experimental.kotlin.lint.ktlint", \
        "pants.backend.experimental.openapi", \
        "pants.backend.experimental.openapi.lint.openapi_format", \
        "pants.backend.experimental.openapi.lint.spectral", \
        "pants.backend.experimental.python", \
        "pants.backend.experimental.python.framework.stevedore", \
        "pants.backend.experimental.python.lint.add_trailing_comma", \
        "pants.backend.experimental.python.lint.ruff", \
        "pants.backend.experimental.python.packaging.pyoxidizer", \
        "pants.backend.experimental.python.typecheck.pytype", \
        "pants.backend.experimental.scala", \
        "pants.backend.experimental.scala.lint.scalafmt", \
        "pants.backend.experimental.terraform", \
        "pants.backend.experimental.tools.semgrep", \
        "pants.backend.experimental.tools.workunit_logger", \
        "pants.backend.experimental.tools.yamllint", \
        "pants.backend.google_cloud_function.python", \
        "pants.backend.plugin_development", \
        "pants.backend.python", \
        "pants.backend.python.lint.autoflake", \
        "pants.backend.python.lint.bandit", \
        "pants.backend.python.lint.black", \
        "pants.backend.python.lint.docformatter", \
        "pants.backend.python.lint.flake8", \
        "pants.backend.python.lint.isort", \
        "pants.backend.python.lint.pydocstyle", \
        "pants.backend.python.lint.pylint", \
        "pants.backend.python.lint.pyupgrade", \
        "pants.backend.python.lint.yapf", \
        "pants.backend.python.mixed_interpreter_constraints", \
        "pants.backend.python.typecheck.mypy", \
        "pants.backend.shell", \
        "pants.backend.shell.lint.shellcheck", \
        "pants.backend.shell.lint.shfmt", \
        "pants.backend.tools.preamble", \
    ]' \
    help-all > "$HERE/2.19.x.help-all.json"

PANTS_VERSION=2.20.0.dev2 /home/josh/work/scie-pants/dist/scie-pants-linux-x86_64 \
    --backend-packages='[ \
        "pants.backend.build_files.fix.deprecations", \
        "pants.backend.build_files.fmt.black", \
        "pants.backend.build_files.fmt.buildifier", \
        "pants.backend.build_files.fmt.yapf", \
        "pants.backend.awslambda.python", \
        "pants.backend.codegen.protobuf.lint.buf", \
        "pants.backend.codegen.protobuf.python", \
        "pants.backend.codegen.thrift.apache.python", \
        "pants.backend.docker", \
        "pants.backend.docker.lint.hadolint", \
        "pants.backend.experimental.adhoc", \
        "pants.backend.experimental.codegen.protobuf.go", \
        "pants.backend.experimental.codegen.protobuf.java", \
        "pants.backend.experimental.codegen.protobuf.scala", \
        "pants.backend.experimental.go", \
        "pants.backend.experimental.helm", \
        "pants.backend.experimental.java", \
        "pants.backend.experimental.java.lint.google_java_format", \
        "pants.backend.experimental.kotlin", \
        "pants.backend.experimental.kotlin.lint.ktlint", \
        "pants.backend.experimental.openapi", \
        "pants.backend.experimental.openapi.lint.openapi_format", \
        "pants.backend.experimental.openapi.lint.spectral", \
        "pants.backend.experimental.python", \
        "pants.backend.experimental.python.framework.stevedore", \
        "pants.backend.experimental.python.lint.add_trailing_comma", \
        "pants.backend.experimental.python.lint.ruff", \
        "pants.backend.experimental.python.packaging.pyoxidizer", \
        "pants.backend.experimental.python.typecheck.pytype", \
        "pants.backend.experimental.scala", \
        "pants.backend.experimental.scala.lint.scalafmt", \
        "pants.backend.experimental.terraform", \
        "pants.backend.experimental.tools.semgrep", \
        "pants.backend.experimental.tools.workunit_logger", \
        "pants.backend.experimental.tools.yamllint", \
        "pants.backend.google_cloud_function.python", \
        "pants.backend.plugin_development", \
        "pants.backend.python", \
        "pants.backend.python.lint.autoflake", \
        "pants.backend.python.lint.bandit", \
        "pants.backend.python.lint.black", \
        "pants.backend.python.lint.docformatter", \
        "pants.backend.python.lint.flake8", \
        "pants.backend.python.lint.isort", \
        "pants.backend.python.lint.pydocstyle", \
        "pants.backend.python.lint.pylint", \
        "pants.backend.python.lint.pyupgrade", \
        "pants.backend.python.lint.yapf", \
        "pants.backend.python.mixed_interpreter_constraints", \
        "pants.backend.python.typecheck.mypy", \
        "pants.backend.shell", \
        "pants.backend.shell.lint.shellcheck", \
        "pants.backend.shell.lint.shfmt", \
        "pants.backend.tools.preamble", \
    ]' \
    help-all > "$HERE/2.20.x.help-all.json"
```
</details>

.github/workflows/sync_docs.yml

@@ -63,6 +63,7 @@ jobs:
       - run: |
           rm -rf "pantsbuild.org/${{ steps.get-destination-dir.outputs.DESTINATION_DIR }}"
           mkdir "pantsbuild.org/${{ steps.get-destination-dir.outputs.DESTINATION_DIR }}"
+          cp help-all.json "pantsbuild.org/${{ steps.get-destination-dir.outputs.DESTINATION_DIR }}"
 
       # Generate reference docs
       - name: Setup Node
@@ -82,7 +83,7 @@ jobs:
       - run: yarn install --frozen-lockfile
         working-directory: pantsbuild.org
       - name: Generate reference docs
-        run: npm run generate-reference "${{ steps.get-destination-dir.outputs.DESTINATION_DIR }}" ../help-all.json
+        run: npm run generate-reference "${{ steps.get-destination-dir.outputs.DESTINATION_DIR }}"
         working-directory: pantsbuild.org
 
       # Sync the docs repo

reference_codegen/generate.js

@@ -3,7 +3,10 @@ const fs = require("fs");
 const path = require("path");
 const he = require("he");
 
-const helpAll = JSON.parse(fs.readFileSync(process.argv[3], "utf8"));
+const reference_dir = path.join(process.argv[2], "reference");
+const helpAll = JSON.parse(
+  fs.readFileSync(path.join(reference_dir, "help-all.json"), "utf8")
+);
 const subsystemTemplate = fs.readFileSync(
   "reference_codegen/subsystem.mdx.mustache",
   "utf8"
@@ -137,7 +140,6 @@ Object.entries(helpAll.name_to_target_type_info).forEach(([name, info]) => {
   });
 });
 
-const reference_dir = path.join(process.argv[2], "reference");
 fs.mkdirSync(reference_dir);
 process.chdir(reference_dir);
 fs.mkdirSync("goals");