From d107d45bc1cb7f99c219c4f43168bd1053584aa0 Mon Sep 17 00:00:00 2001 From: James Sharpe Date: Mon, 18 Nov 2024 23:19:54 +0000 Subject: [PATCH] chore(docs): Remove very old versions of the docs. --- .github/docs-0.1.0.patch | 55 --------------------- .github/docs-0.2.0.patch | 55 --------------------- .github/docs-0.3.0.patch | 95 ------------------------------------ .github/workflows/pages.yaml | 43 ++++++++-------- 4 files changed, 20 insertions(+), 228 deletions(-) delete mode 100644 .github/docs-0.1.0.patch delete mode 100644 .github/docs-0.2.0.patch delete mode 100644 .github/docs-0.3.0.patch diff --git a/.github/docs-0.1.0.patch b/.github/docs-0.1.0.patch deleted file mode 100644 index 7e6133ca..00000000 --- a/.github/docs-0.1.0.patch +++ /dev/null @@ -1,55 +0,0 @@ -diff --git a/docs/BUILD.bazel b/docs/BUILD.bazel -index a5a37ac..e381ce8 100644 ---- a/docs/BUILD.bazel -+++ b/docs/BUILD.bazel -@@ -35,7 +35,7 @@ genrule( - cmd = """cat << EOF > $@ - #!/bin/bash - set -e --cat \\$${BUILD_WORKSPACE_DIRECTORY}/$(location //:docs) > \\$${BUILD_WORKSPACE_DIRECTORY}/README.md -+cat \\$${BUILD_WORKSPACE_DIRECTORY}/$(location //:docs) > \\$${BUILD_WORKSPACE_DIRECTORY}/src/index.md - """, - ) - -diff --git a/docs/book.toml b/docs/book.toml -new file mode 100644 -index 0000000..5096728 ---- /dev/null -+++ b/docs/book.toml -@@ -0,0 +1,5 @@ -+[book] -+title = "Rules ForeignCc" -+ -+[output.html] -+git-repository-url = "https://github.com/bazel-contrib/rules_foreign_cc" -diff --git a/docs/src/SUMMARY.md b/docs/src/SUMMARY.md -new file mode 100644 -index 0000000..69fbd4d ---- /dev/null -+++ b/docs/src/SUMMARY.md -@@ -0,0 +1,3 @@ -+# SUMMARY -+ -+- [Rules ForeignCc](index.md) -diff --git a/version.bzl b/version.bzl -new file mode 100644 -index 0000000..98bb722 ---- /dev/null -+++ b/version.bzl -@@ -0,0 +1,3 @@ -+"""A module represeting the version of rules_foreign_cc""" -+ -+VERSION = "0.1.0" -diff --git a/docs/.bazelrc b/docs/.bazelrc -new file mode 100644 -index 0000000..9eb0697 ---- /dev/null -+++ b/docs/.bazelrc -@@ -0,0 +1,7 @@ -+# Bazel configuration flags for rules_foreign_cc_docs -+ -+# https://github.com/bazelbuild/stardoc/issues/112 -+common --incompatible_allow_tags_propagation -+ -+common --noenable_bzlmod -+build --workspace_status_command=tools/workspace_status.sh diff --git a/.github/docs-0.2.0.patch b/.github/docs-0.2.0.patch deleted file mode 100644 index 5a507563..00000000 --- a/.github/docs-0.2.0.patch +++ /dev/null @@ -1,55 +0,0 @@ -diff --git a/docs/BUILD.bazel b/docs/BUILD.bazel -index a5a37ac..091e679 100644 ---- a/docs/BUILD.bazel -+++ b/docs/BUILD.bazel -@@ -35,7 +35,7 @@ genrule( - cmd = """cat << EOF > $@ - #!/bin/bash - set -e --cat \\$${BUILD_WORKSPACE_DIRECTORY}/$(location //:docs) > \\$${BUILD_WORKSPACE_DIRECTORY}/README.md -+cat \\$${BUILD_WORKSPACE_DIRECTORY}/$(location //:docs) > \\$${BUILD_WORKSPACE_DIRECTORY}/src/index.md - """, - ) - -diff --git a/docs/book.toml b/docs/book.toml -new file mode 100644 -index 0000000..5096728 ---- /dev/null -+++ b/docs/book.toml -@@ -0,0 +1,5 @@ -+[book] -+title = "Rules ForeignCc" -+ -+[output.html] -+git-repository-url = "https://github.com/bazel-contrib/rules_foreign_cc" -diff --git a/docs/src/SUMMARY.md b/docs/src/SUMMARY.md -new file mode 100644 -index 0000000..69fbd4d ---- /dev/null -+++ b/docs/src/SUMMARY.md -@@ -0,0 +1,3 @@ -+# SUMMARY -+ -+- [Rules ForeignCc](index.md) -diff --git a/version.bzl b/version.bzl -new file mode 100644 -index 0000000..98bb722 ---- /dev/null -+++ b/version.bzl -@@ -0,0 +1,3 @@ -+"""A module represeting the version of rules_foreign_cc""" -+ -+VERSION = "0.2.0" -diff --git a/docs/.bazelrc b/docs/.bazelrc -new file mode 100644 -index 0000000..9eb0697 ---- /dev/null -+++ b/docs/.bazelrc -@@ -0,0 +1,7 @@ -+# Bazel configuration flags for rules_foreign_cc_docs -+ -+# https://github.com/bazelbuild/stardoc/issues/112 -+common --incompatible_allow_tags_propagation -+ -+common --noenable_bzlmod -+build --workspace_status_command=tools/workspace_status.sh diff --git a/.github/docs-0.3.0.patch b/.github/docs-0.3.0.patch deleted file mode 100644 index 835689e2..00000000 --- a/.github/docs-0.3.0.patch +++ /dev/null @@ -1,95 +0,0 @@ -diff --git a/docs/BUILD.bazel b/docs/BUILD.bazel -index 461df15..efa4c26 100644 ---- a/docs/BUILD.bazel -+++ b/docs/BUILD.bazel -@@ -68,16 +68,17 @@ build_test( - - genrule( - name = "generate_docs_src", -- srcs = DOCS_TARGETS, -+ srcs = DOCS_TARGETS + ["index.md"], - outs = ["generate_docs.sh"], - cmd = """cat << EOF > $@ - #!/bin/bash - set -euo pipefail --cat \\$${BUILD_WORKSPACE_DIRECTORY}/$(location //:flatten_docs) > \\$${BUILD_WORKSPACE_DIRECTORY}/flatten.md --cat \\$${BUILD_WORKSPACE_DIRECTORY}/$(location //:cmake_docs) > \\$${BUILD_WORKSPACE_DIRECTORY}/cmake.md --cat \\$${BUILD_WORKSPACE_DIRECTORY}/$(location //:ninja_docs) > \\$${BUILD_WORKSPACE_DIRECTORY}/ninja.md --cat \\$${BUILD_WORKSPACE_DIRECTORY}/$(location //:make_docs) > \\$${BUILD_WORKSPACE_DIRECTORY}/make.md --cat \\$${BUILD_WORKSPACE_DIRECTORY}/$(location //:configure_make_docs) > \\$${BUILD_WORKSPACE_DIRECTORY}/configure_make.md -+cat \\$${BUILD_WORKSPACE_DIRECTORY}/$(location //:flatten_docs) > \\$${BUILD_WORKSPACE_DIRECTORY}/src/flatten.md -+cat \\$${BUILD_WORKSPACE_DIRECTORY}/$(location //:cmake_docs) > \\$${BUILD_WORKSPACE_DIRECTORY}/src/cmake.md -+cat \\$${BUILD_WORKSPACE_DIRECTORY}/$(location //:ninja_docs) > \\$${BUILD_WORKSPACE_DIRECTORY}/src/ninja.md -+cat \\$${BUILD_WORKSPACE_DIRECTORY}/$(location //:make_docs) > \\$${BUILD_WORKSPACE_DIRECTORY}/src/make.md -+cat \\$${BUILD_WORKSPACE_DIRECTORY}/$(location //:configure_make_docs) > \\$${BUILD_WORKSPACE_DIRECTORY}/src/configure_make.md -+cp \\$${BUILD_WORKSPACE_DIRECTORY}/$(rootpath index.md) \\$${BUILD_WORKSPACE_DIRECTORY}/src/index.md - EOF - """, - ) -diff --git a/docs/book.toml b/docs/book.toml -new file mode 100644 -index 0000000..5096728 ---- /dev/null -+++ b/docs/book.toml -@@ -0,0 +1,5 @@ -+[book] -+title = "Rules ForeignCc" -+ -+[output.html] -+git-repository-url = "https://github.com/bazel-contrib/rules_foreign_cc" -diff --git a/docs/index.md b/docs/index.md -index 3a91e41..14c8e3b 100644 ---- a/docs/index.md -+++ b/docs/index.md -@@ -21,9 +21,12 @@ load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive") - - http_archive( - name = "rules_foreign_cc", -- sha256 = "d54742ffbdc6924f222d2179f0e10e911c5c659c4ae74158e9fe827aad862ac6", -- strip_prefix = "rules_foreign_cc-0.2.0", -- url = "https://github.com/bazel-contrib/rules_foreign_cc/archive/0.2.0.tar.gz", -+ # TODO: Get the latest sha256 value from the latest release on the releases page -+ # https://github.com/bazel-contrib/rules_foreign_cc/releases -+ # -+ # sha256 = "...", -+ strip_prefix = "rules_foreign_cc-0.3.0", -+ url = "https://github.com/bazel-contrib/rules_foreign_cc/archive/0.3.0.tar.gz", - ) - - load("@rules_foreign_cc//foreign_cc:repositories.bzl", "rules_foreign_cc_dependencies") -diff --git a/docs/src/SUMMARY.md b/docs/src/SUMMARY.md -new file mode 100644 -index 0000000..9e77270 ---- /dev/null -+++ b/docs/src/SUMMARY.md -@@ -0,0 +1,8 @@ -+# SUMMARY -+ -+- [Rules ForeignCc](index.md) -+ - [cmake](cmake.md) -+ - [configure_make](configure_make.md) -+ - [make](make.md) -+ - [ninja](ninja.md) -+ - [Full API](flatten.md) -diff --git a/version.bzl b/version.bzl -new file mode 100644 -index 0000000..98bb722 ---- /dev/null -+++ b/version.bzl -@@ -0,0 +1,3 @@ -+"""A module represeting the version of rules_foreign_cc""" -+ -+VERSION = "0.3.0" -diff --git a/docs/.bazelrc b/docs/.bazelrc -new file mode 100644 -index 0000000..9eb0697 ---- /dev/null -+++ b/docs/.bazelrc -@@ -0,0 +1,7 @@ -+# Bazel configuration flags for rules_foreign_cc_docs -+ -+# https://github.com/bazelbuild/stardoc/issues/112 -+common --incompatible_allow_tags_propagation -+ -+common --noenable_bzlmod -+build --workspace_status_command=tools/workspace_status.sh diff --git a/.github/workflows/pages.yaml b/.github/workflows/pages.yaml index e9ca9f7f..2bff866e 100644 --- a/.github/workflows/pages.yaml +++ b/.github/workflows/pages.yaml @@ -1,11 +1,11 @@ name: Generate docs on: - pull_request: + pull_request: branches: - main paths: - - '.github/**' - - 'docs/**' + - ".github/**" + - "docs/**" push: branches: - main @@ -29,9 +29,6 @@ jobs: - ref: "0.5.1" - ref: "0.5.0" - ref: "0.4.0" - - ref: "0.3.0" - - ref: "0.2.0" - - ref: "0.1.0" steps: - uses: actions/checkout@v2 if: ${{ matrix.ref == 'main' }} @@ -101,20 +98,20 @@ jobs: if: ${{ github.event_name != 'pull_request' }} runs-on: ubuntu-latest steps: - - name: Fetch artifacts (first root then others so the ordering is correct) - uses: actions/download-artifact@v2 - with: - name: main-root - path: ${{ github.workspace }}/docs/book - - name: Fetch artifacts (first root then others so the ordering is correct) - uses: actions/download-artifact@v2 - with: - path: ${{ github.workspace }}/docs/pages - - name: Install pages - run: mv ${{ github.workspace }}/docs/pages/* ${{ github.workspace }}/docs/book/ - - name: publish - uses: peaceiris/actions-gh-pages@v3 - with: - github_token: ${{ secrets.GITHUB_TOKEN }} - publish_branch: docs - publish_dir: ./docs/book + - name: Fetch artifacts (first root then others so the ordering is correct) + uses: actions/download-artifact@v2 + with: + name: main-root + path: ${{ github.workspace }}/docs/book + - name: Fetch artifacts (first root then others so the ordering is correct) + uses: actions/download-artifact@v2 + with: + path: ${{ github.workspace }}/docs/pages + - name: Install pages + run: mv ${{ github.workspace }}/docs/pages/* ${{ github.workspace }}/docs/book/ + - name: publish + uses: peaceiris/actions-gh-pages@v3 + with: + github_token: ${{ secrets.GITHUB_TOKEN }} + publish_branch: docs + publish_dir: ./docs/book