chore: publish stardocs on releases

Author: alexeagle

.bcr/source.template.json

@@ -1,5 +1,6 @@
 {
   "integrity": "**leave this alone**",
   "strip_prefix": "{REPO}-{VERSION}",
+  "docs_url": "https://github.com/{OWNER}/{REPO}/releases/download/{TAG}/{REPO}-{TAG}.docs.tar.gz",
   "url": "https://github.com/{OWNER}/{REPO}/releases/download/{TAG}/bazel-lib-{TAG}.tar.gz"
 }

.github/workflows/publish.yaml

@@ -21,7 +21,7 @@ on:
         type: string
 jobs:
   publish:
-    uses: bazel-contrib/publish-to-bcr/.github/workflows/[email protected].2
+    uses: bazel-contrib/publish-to-bcr/.github/workflows/[email protected].3
     with:
       tag_name: ${{ inputs.tag_name }}
       # GitHub repository which is a fork of the upstream where the Pull Request will be opened.

.github/workflows/release_prep.sh

@@ -43,6 +43,14 @@ tar --file $ARCHIVE_TMP --append ${PREFIX}/tools/integrity.bzl
 gzip <$ARCHIVE_TMP >$ARCHIVE
 SHA=$(shasum -a 256 $ARCHIVE | awk '{print $1}')
 
+# Add generated API docs to the release, see https://github.com/bazelbuild/bazel-central-registry/issues/5593
+docs="$(mktemp -d)"
+bazel --output_base="$docs" query --output=label 'kind("starlark_doc_extract rule", //...)' \
+    | xargs bazel --output_base="$docs" build --remote_download_regex='.*doc_extract\.binaryproto'
+tar --create --auto-compress \
+    --directory "$(bazel --output_base="$docs" info bazel-bin)" \
+    --file "$GITHUB_WORKSPACE/${ARCHIVE%.tar.gz}.docs.tar.gz" .
+
 cat <<EOF
 
 ## Using Bzlmod with Bazel 6: