Fix and run //docs:update

Author: guw

MODULE.bazel

@@ -9,6 +9,9 @@ module(
 bazel_dep(name = "bazel_skylib", version = "1.4.1")
 bazel_dep(name = "platforms", version = "0.0.5")
 
+# workaround for https://github.com/bazelbuild/bazel/issues/25124
+bazel_dep(name = "zlib", version = "1.3.1.bcr.6", dev_dependency = True)
+
 node = use_extension("@rules_nodejs//nodejs:extensions.bzl", "node")
 
 # Note, this gets the default version of Node.js from

WORKSPACE

@@ -60,6 +60,19 @@ http_archive(
 # Dependencies & toolchains needed for unit tests & generating documentation
 #
 
+# workaround for https://github.com/bazelbuild/bazel/issues/25124
+zlib_version = "1.3.1"
+
+zlib_sha256 = "9a93b2b7dfdac77ceba5a558a580e74667dd6fede4585b91eefb60f03b72df23"
+
+http_archive(
+    name = "zlib",
+    build_file = "@com_google_protobuf//:third_party/zlib.BUILD",
+    sha256 = zlib_sha256,
+    strip_prefix = "zlib-%s" % zlib_version,
+    urls = ["https://github.com/madler/zlib/releases/download/v{v}/zlib-{v}.tar.gz".format(v = zlib_version)],
+)
+
 load("@aspect_bazel_lib//lib:repositories.bzl", "aspect_bazel_lib_dependencies", "register_copy_directory_toolchains", "register_copy_to_directory_toolchains")
 
 aspect_bazel_lib_dependencies()

docs/Core.md

@@ -183,7 +183,7 @@ nodejs_toolchain(
 ```
 
 Next, declare which execution platforms or target platforms the toolchain should be selected for
-based on constraints.
+based on constraints. A separate toolchain type is used for runtime target platform selection.
 
 ```starlark
 toolchain(
@@ -195,6 +195,15 @@ toolchain(
     toolchain = ":toolchain",
     toolchain_type = "@rules_nodejs//nodejs:toolchain_type",
 )
+toolchain(
+    name = "my_nodejs_runtime",
+    target_compatible_with = [
+        "@platforms//os:linux",
+        "@platforms//cpu:x86_64",
+    ],
+    toolchain = ":toolchain",
+    toolchain_type = "@rules_nodejs//nodejs:runtime_toolchain_type",
+)
 ```
 
 See https://bazel.build/extending/toolchains#toolchain-resolution for more information on toolchain