Move reference-docs generation tools into docs/ subdir

Signed-off-by: James Munnelly <james@munnelly.eu>

WORKSPACE

@@ -191,7 +191,7 @@ load("@build_bazel_rules_nodejs//:defs.bzl", "npm_install")
 npm_install(
     name = "brodocs_modules",
     package_json = "@brodocs//:package.json",
-    package_lock_json = "//hack/reference-docs/bin:package-lock.json",
+    package_lock_json = "//docs/generated/reference/generate/bin:package-lock.json",
 )
 
 # Load kubernetes-incubator/reference-docs, to be used as part of the docs

docs/generated/reference/BUILD.bazel

@@ -7,7 +7,16 @@ filegroup(
 
 filegroup(
     name = "all-srcs",
-    srcs = [":package-srcs"],
+    srcs = [
+        ":package-srcs",
+        "//docs/generated/reference/generate:all-srcs",
+    ],
     tags = ["automanaged"],
     visibility = ["//visibility:public"],
 )
+
+filegroup(
+    name = "output",
+    srcs = glob(["output/**/*"]),
+    visibility = ["//visibility:public"],
+)

docs/generated/reference/generate/BUILD.bazel

@@ -1,9 +1,9 @@
 genrule(
     name = "__internal_markdown_tar",
     srcs = [
-        "//hack/reference-docs:config.yaml",
-        "//hack/reference-docs/static_includes:all-srcs",
-        "//hack/reference-docs/json_swagger:swagger.json",
+        "//docs/generated/reference/generate:config.yaml",
+        "//docs/generated/reference/generate/static_includes:all-srcs",
+        "//docs/generated/reference/generate/json_swagger:swagger.json",
     ],
     outs = ["defs.tar.gz"],
     cmd = "; ".join([
@@ -11,9 +11,9 @@ genrule(
         "mkdir -p \"$$tmpdir/static_includes/\"",
         "mkdir -p \"$$tmpdir/includes/\"",
         "mkdir -p \"$$tmpdir/openapi-spec/\"",
-        "cp -L \"$(location //hack/reference-docs/json_swagger:swagger.json)\" \"$$tmpdir/openapi-spec/\"",
-        "cp -L \"$(location //hack/reference-docs:config.yaml)\" \"$$tmpdir/\"",
-        "cp -LR $(locations //hack/reference-docs/static_includes:all-srcs) \"$$tmpdir/static_includes/\"",
+        "cp -L \"$(location //docs/generated/reference/generate/json_swagger:swagger.json)\" \"$$tmpdir/openapi-spec/\"",
+        "cp -L \"$(location //docs/generated/reference/generate:config.yaml)\" \"$$tmpdir/\"",
+        "cp -LR $(locations //docs/generated/reference/generate/static_includes:all-srcs) \"$$tmpdir/static_includes/\"",
         "rm \"$$tmpdir/static_includes/BUILD.bazel\"",
         "$(location @io_kubernetes_incubator_reference_docs//gen-apidocs) --copyright \"<a href=\\\"https://jetstack.io\\\">Copyright 2018 Jetstack Ltd.</a>\" --title \"Cert-manager API Reference\" -config-dir $$tmpdir",
         "orig=$$(pwd)",
@@ -29,7 +29,7 @@ genrule(
 genrule(
     name = "__internal_brodocs_out",
     srcs = [
-        "//hack/reference-docs:__internal_markdown_tar",
+        "//docs/generated/reference/generate:__internal_markdown_tar",
     ],
     outs = [
         "index.html",
@@ -38,13 +38,13 @@ genrule(
     cmd = "; ".join([
         "input=$$(mktemp -d)",
         "output=$$(mktemp -d)",
-        "tar -C \"$$input\" -xf $(location //hack/reference-docs:__internal_markdown_tar)",
-        "$(location //hack/reference-docs/bin:brodocs) \"$$input/manifest.json\" \"$$input/includes\" \"$$output\"",
+        "tar -C \"$$input\" -xf $(location //docs/generated/reference/generate:__internal_markdown_tar)",
+        "$(location //docs/generated/reference/generate/bin:brodocs) \"$$input/manifest.json\" \"$$input/includes\" \"$$output\"",
         "cp $$output/index.html $(@D)",
         "cp $$output/navData.js $(@D)",
     ]),
     tools = [
-        "//hack/reference-docs/bin:brodocs",
+        "//docs/generated/reference/generate/bin:brodocs",
     ],
     visibility = ["//visibility:private"],
 )
@@ -54,7 +54,7 @@ genrule(
 # The output this script is then consumed by the hack/update-reference-docs.sh
 # to place the data into the correct directory to be displayed by readthedocs.
 genrule(
-    name = "reference-docs",
+    name = "generate",
     srcs = [
         ":__internal_brodocs_out",
         "@brodocs//:static",
@@ -94,10 +94,10 @@ filegroup(
     name = "all-srcs",
     srcs = [
         ":package-srcs",
-        "//hack/reference-docs/bin:all-srcs",
-        "//hack/reference-docs/go_openapi:all-srcs",
-        "//hack/reference-docs/json_swagger:all-srcs",
-        "//hack/reference-docs/static_includes:all-srcs",
+        "//docs/generated/reference/generate/bin:all-srcs",
+        "//docs/generated/reference/generate/go_openapi:all-srcs",
+        "//docs/generated/reference/generate/json_swagger:all-srcs",
+        "//docs/generated/reference/generate/static_includes:all-srcs",
     ],
     tags = ["automanaged"],
     visibility = ["//visibility:public"],

docs/generated/reference/generate/go_openapi/BUILD.bazel

@@ -2,7 +2,7 @@
 
 package(default_visibility = ["//visibility:public"])
 
-load("//hack/reference-docs/go_openapi:def.bzl", "openapi_library")
+load("//docs/generated/reference/generate/go_openapi:def.bzl", "openapi_library")
 
 openapi_library(
     name = "go_default_library",
@@ -11,7 +11,7 @@ openapi_library(
     openapi_targets = [
         "pkg/apis/certmanager/v1alpha1",
     ],
-    tags = ["manual"],
+    tags = ["docs"],
     vendor_targets = [
         "k8s.io/apimachinery/pkg/apis/meta/v1",
         "k8s.io/apimachinery/pkg/runtime",

docs/generated/reference/generate/go_openapi/def.bzl

@@ -23,7 +23,7 @@ def openapi_library(name, tags, srcs, go_prefix, openapi_targets = [], vendor_ta
     go_library(
         name = name,
         srcs = srcs + [":zz_generated.openapi"],
-        importpath = go_prefix + "hack/reference-docs/go_openapi",
+        importpath = go_prefix + "docs/generated/reference/generate/go_openapi",
         tags = tags,
         deps = deps,
     )
@@ -42,10 +42,10 @@ def openapi_library(name, tags, srcs, go_prefix, openapi_targets = [], vendor_ta
             "--logtostderr",
             "--go-header-file $$GO_GENRULE_EXECROOT/$(location //hack/boilerplate:boilerplate.go.txt)",
             "--output-file-base zz_generated.openapi",
-            "--output-package " + go_prefix + "hack/reference-docs/go_openapi",
+            "--output-package " + go_prefix + "docs/generated/reference/generate/go_openapi",
             # "--report-filename tmp_api_violations.report",
             "--input-dirs " + ",".join([go_prefix + target for target in openapi_targets] + [go_prefix + "vendor/" + target for target in vendor_targets]),
-            "&& cp $$GOPATH/src/" + go_prefix + "hack/reference-docs/go_openapi/zz_generated.openapi.go $$GO_GENRULE_EXECROOT/$(location :zz_generated.openapi.go)",
+            "&& cp $$GOPATH/src/" + go_prefix + "docs/generated/reference/generate/go_openapi/zz_generated.openapi.go $$GO_GENRULE_EXECROOT/$(location :zz_generated.openapi.go)",
         ]),
         go_deps = deps,
         tools = ["//vendor/k8s.io/kube-openapi/example/openapi-gen"],

docs/generated/reference/generate/json_swagger/BUILD.bazel

@@ -17,11 +17,11 @@ filegroup(
 go_library(
     name = "go_default_library",
     srcs = ["main.go"],
-    importpath = "github.com/jetstack/cert-manager/hack/reference-docs/json_swagger",
+    importpath = "github.com/jetstack/cert-manager/docs/generated/reference/generate/json_swagger",
     tags = ["manual"],
     visibility = ["//visibility:private"],
     deps = [
-        "//hack/reference-docs/go_openapi:go_default_library",
+        "//docs/generated/reference/generate/go_openapi:go_default_library",
         "//vendor/github.com/go-openapi/spec:go_default_library",
         "//vendor/k8s.io/kube-openapi/pkg/common:go_default_library",
     ],
@@ -38,7 +38,7 @@ genrule(
     name = "swagger",
     outs = ["swagger.json"],
     cmd = "; ".join([
-        "$(locations //hack/reference-docs/json_swagger:generator) > $@",
+        "$(locations //docs/generated/reference/generate/json_swagger:generator) > $@",
     ]),
     tools = [":generator"],
     visibility = ["//visibility:public"],

docs/generated/reference/generate/json_swagger/main.go

@@ -26,7 +26,7 @@ import (
 	"github.com/go-openapi/spec"
 	"k8s.io/kube-openapi/pkg/common"
 
-	openapi "github.com/jetstack/cert-manager/hack/reference-docs/go_openapi"
+	openapi "github.com/jetstack/cert-manager/docs/generated/reference/generate/go_openapi"
 )
 
 func main() {

hack/BUILD.bazel

@@ -118,10 +118,7 @@ sh_binary(
     name = "update-reference-docs",
     srcs = ["update-reference-docs.sh"],
     data = [
-        "//hack/reference-docs",
-    ],
-    deps = [
-        "@bazel_tools//tools/bash/runfiles",
+        "//docs/generated/reference/generate",
     ],
 )
 
@@ -129,12 +126,9 @@ sh_test(
     name = "verify-reference-docs",
     srcs = ["verify-reference-docs.sh"],
     data = [
-        "//docs/generated/reference:all-srcs",
+        "//docs/generated/reference:output",
+        "//docs/generated/reference/generate",
         "//hack:update-reference-docs.sh",
-        "//hack/reference-docs",
-    ],
-    deps = [
-        "@bazel_tools//tools/bash/runfiles",
     ],
 )
 
@@ -171,7 +165,6 @@ filegroup(
         "//hack/bin:all-srcs",
         "//hack/boilerplate:all-srcs",
         "//hack/deploy:all-srcs",
-        "//hack/reference-docs:all-srcs",
     ],
     tags = ["automanaged"],
     visibility = ["//visibility:public"],

hack/update-reference-docs.sh

@@ -28,7 +28,7 @@ OUTPUT_DIR="$(cd "${REPO_ROOT}/docs/generated/reference/output/reference/api-doc
 
 TMP_OUTPUT="$(mktemp -d)"
 
-tar -C "${TMP_OUTPUT}" -xf "${SCRIPT_RUNFILES}/hack/reference-docs/generated.tar.gz"
+tar -C "${TMP_OUTPUT}" -xf "${SCRIPT_RUNFILES}/docs/generated/reference/generate/generated.tar.gz"
 
 rm -Rf "${OUTPUT_DIR}"
 mkdir -p "${OUTPUT_DIR}"