feat: publish docs with releases

Author: alexeagle

.github/workflows/release_ruleset.yaml

@@ -59,6 +59,13 @@ on:
         default: true
         description: Indicator of whether or not this is a prerelease.
         type: boolean
+      docs:
+        default: false
+        description: |
+          Indicator of whether or not to generate starlark documentation from bzl_library targets.
+          When true, an additional release artifact will be produced, which is an archive file of the binary protobuf files
+          output by the [starlark_doc_extract](https://bazel.build/reference/be/general#starlark_doc_extract) rule.
+        type: boolean
       draft:
         default: false
         description: |
@@ -94,7 +101,7 @@ jobs:
       # Fetch built artifacts (if any) from earlier jobs, which the release script may want to read.
       # Extract into ${GITHUB_WORKSPACE}/artifacts/*
       - uses: actions/download-artifact@95815c38cf2ff2164869cbab79da8d1f422bc89e # v4.2.1
-    
+
       - name: Build release artifacts and prepare release notes
         run: |
           if [ ! -f ".github/workflows/release_prep.sh" ]; then
@@ -103,6 +110,22 @@ jobs:
           fi
           .github/workflows/release_prep.sh ${{ inputs.tag_name || github.ref_name }} > release_notes.txt
 
+      - name: Generate starlark documentation
+        if: inputs.docs
+        run: |
+          echo >.bazelversion "7.6.1"
+          cat >MODULE.bazel <<EOF
+          module(
+              name = "rules_oci",
+              version = "0.0.0",
+          )
+          local_path_override(
+              module_name = "rules_oci",
+              path = "${{GITHUB_WORKSPACE}}",
+          )
+          EOF
+          bazel build @rules_oci//oci:defs.docs-as-proto
+
       - uses: actions/upload-artifact@65c4c4a1ddee5b72f698fdd19549f0f0fb45cf08 #v4.6.0
         id: upload-release-files
         with: