Generate reference documentation at publish-time and the JSON schema at release-time (#16969)

It'd be nice to avoid churn for contributors. This is a pretty frequent
cause of CI failures and I don't think we really need to have the
reference documentation committed.

.github/workflows/publish-docs.yml

@@ -36,6 +36,14 @@ jobs:
         with:
           python-version: 3.12
 
+      - uses: Swatinem/rust-cache@98c8021b550208e191a6a3145459bfc9fb29c4c0 # v2.8.0
+
+      - name: "Generate reference documentation"
+        run: |
+          cargo dev generate-options-reference
+          cargo dev generate-cli-reference
+          cargo dev generate-env-vars-reference
+
       - name: "Set docs display name"
         run: |
           version="${VERSION}"