docs: refresh docsite

.bazelci/presubmit.yml

@@ -128,9 +128,9 @@ tasks:
     # TODO(gregmagolan): figure out how to install missing shared libs
     # Without this filter the @cypress external repository will be built and that build will fail due to missing shared libs.
     - "--build_tag_filters=-cypress"
-    # This target is tagged "manual" but we want some CI
-    # coverage of it to make sure it doesn't break.
-    - "//docs"
+    # Build the docs up to the point of running Jekyll as this requires some locally installed deps
+    # Building the stardoc targets provides a little test coverage in formatting etc
+    - "//docs:builtins_md"
     test_flags:
     # Both chrome & firefox are missing shared libs on bazelci ubuntu.
     # On circleci we have the same issue but we can work around it using apt-get.

docs/BUILD.bazel

@@ -12,7 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-load("//tools/stardoc:index.bzl", "stardoc")
+load("//tools/stardoc:index.bzl", "rules_nodejs_docs", "stardoc")
 
 stardoc(
     name = "builtins",
@@ -53,45 +53,35 @@ genrule(
     tags = ["fix-windows"],
 )
 
-_PACKAGE_READMES = {
-    "Built-ins": ":builtins.doc",
-    "Cypress": "//packages/cypress:README.md",
-    "Jasmine": "//packages/jasmine:README.md",
-    "Karma": "//packages/karma:README.md",
-    "Protractor": "//packages/protractor:README.md",
-    "Rollup": "//packages/rollup:README.md",
-    "Terser": "//packages/terser:README.md",
-    "TypeScript": "//packages/typescript:README.md",
-}
-
-_FRONT_MATTER = "\n".join([
-    "---",
-    "title: %s",
-    "layout: default",
-    "stylesheet: docs",
-    "---",
-    "<!-- *********************",
-    " DO NOT EDIT THIS FILE",
-    "  It is a generated build output from Stardoc.",
-    "  Instead you must edit the .bzl file where the rules are declared,",
-    "  or possibly a markdown file next to the .bzl file",
-    " ********************* -->",
-])
-
-[
-    genrule(
-        name = "%s_md" % readme[0],
-        srcs = [readme[1]],
-        outs = [readme[0] + ".md"],
-        cmd = "echo '%s' > $@;" % _FRONT_MATTER % readme[0] +
-              "cat $< >> $@",
-        tags = ["fix-windows"],
-    )
-    for readme in _PACKAGE_READMES.items()
-]
-
-filegroup(
+rules_nodejs_docs(
     name = "docs",
-    srcs = [s + ".md" for s in _PACKAGE_READMES.keys()],
-    tags = ["fix-windows"],
+    assets = glob(["images/*"]),
+    config = "_config.yml",
+    css = "//docs/css",
+    docs = [
+        "install.md",
+        "repositories.md",
+        "debugging.md",
+        "dependencies.md",
+        "stamping.md",
+        "index.md",
+        "examples.md",
+        "changing-rules.md",
+    ],
+    includes = glob(["_includes/*"]),
+    layouts = glob(["_layouts/*"]),
+    readmes = {
+        "Built-ins": ":builtins.doc",
+        "Cypress": "//packages/cypress:README.md",
+        "Jasmine": "//packages/jasmine:README.md",
+        "Karma": "//packages/karma:README.md",
+        "Protractor": "//packages/protractor:README.md",
+        "Rollup": "//packages/rollup:README.md",
+        "Terser": "//packages/terser:README.md",
+        "TypeScript": "//packages/typescript:README.md",
+    },
+    tags = [
+        "fix-windows",
+        "manual",
+    ],
 )