feat: introduce ability to patch the upstream

Author: alexeagle

.github/workflows/hugo-site-generator.yml

@@ -39,6 +39,10 @@ jobs:
           working-directory: upstream
           run: git checkout ${{ inputs.bcrCommitHash }}
 
+        - name: Patch upstream docs
+          working-directory: upstream
+          run: patch -p1 < ../patches/*.patch
+
         - name: Clean up mdx files
           run: ./cleanup-mdx.sh
 

configure/attributes.mdx

@@ -44,28 +44,12 @@ config_setting(
 This declares a `cc_binary` that "chooses" its deps based on the flags at the
 command line. Specifically, `deps` becomes:
 
-<table>
-  <tr style="background: #E9E9E9; font-weight: bold">
-    <td>Command</td>
-    <td>deps =</td>
-  </tr>
-  <tr>
-    <td><code>bazel build //myapp:mybinary --cpu=arm</code></td>
-    <td><code>[":arm_lib"]</code></td>
-  </tr>
-  <tr>
-    <td><code>bazel build //myapp:mybinary -c dbg --cpu=x86</code></td>
-    <td><code>[":x86_dev_lib"]</code></td>
-  </tr>
-  <tr>
-    <td><code>bazel build //myapp:mybinary --cpu=ppc</code></td>
-    <td><code>[":generic_lib"]</code></td>
-  </tr>
-  <tr>
-    <td><code>bazel build //myapp:mybinary -c dbg --cpu=ppc</code></td>
-    <td><code>[":generic_lib"]</code></td>
-  </tr>
-</table>
+| Command                                         | deps               |
+| ----------------------------------------------- | ------------------ |
+| `bazel build //myapp:mybinary --cpu=arm`        | `[":arm_lib"]`     |
+| `bazel build //myapp:mybinary -c dbg --cpu=x86` | `[":x86_dev_lib"]` |
+| `bazel build //myapp:mybinary --cpu=ppc`        | `[":generic_lib"]` |
+| `bazel build //myapp:mybinary -c dbg --cpu=ppc` | `[":generic_lib"]` |
 
 `select()` serves as a placeholder for a value that will be chosen based on
 *configuration conditions*, which are labels referencing [`config_setting`](/reference/be/general#config_setting)

configure/best-practices.mdx

@@ -80,7 +80,6 @@ and add `user.bazelrc` to your `.gitignore`.
 
 The open-source
 [bazelrc-preset.bzl](https://github.com/bazel-contrib/bazelrc-preset.bzl)
-
 generates a custom bazelrc file that matches your Bazel version and provides a
 preset of recommended flags.
 

patches/attributes.patch

@@ -0,0 +1,39 @@
+diff --git a/site/en/configure/attributes.md b/site/en/configure/attributes.md
+index 7b55a6f..945ac81 100644
+--- a/site/en/configure/attributes.md
++++ b/site/en/configure/attributes.md
+@@ -45,28 +45,12 @@ config_setting(
+ This declares a `cc_binary` that "chooses" its deps based on the flags at the
+ command line. Specifically, `deps` becomes:
+ 
+-<table>
+-  <tr style="background: #E9E9E9; font-weight: bold">
+-    <td>Command</td>
+-    <td>deps =</td>
+-  </tr>
+-  <tr>
+-    <td><code>bazel build //myapp:mybinary --cpu=arm</code></td>
+-    <td><code>[":arm_lib"]</code></td>
+-  </tr>
+-  <tr>
+-    <td><code>bazel build //myapp:mybinary -c dbg --cpu=x86</code></td>
+-    <td><code>[":x86_dev_lib"]</code></td>
+-  </tr>
+-  <tr>
+-    <td><code>bazel build //myapp:mybinary --cpu=ppc</code></td>
+-    <td><code>[":generic_lib"]</code></td>
+-  </tr>
+-  <tr>
+-    <td><code>bazel build //myapp:mybinary -c dbg --cpu=ppc</code></td>
+-    <td><code>[":generic_lib"]</code></td>
+-  </tr>
+-</table>
++| Command                                         | deps               |
++| ----------------------------------------------- | ------------------ |
++| `bazel build //myapp:mybinary --cpu=arm`        | `[":arm_lib"]`     |
++| `bazel build //myapp:mybinary -c dbg --cpu=x86` | `[":x86_dev_lib"]` |
++| `bazel build //myapp:mybinary --cpu=ppc`        | `[":generic_lib"]` |
++| `bazel build //myapp:mybinary -c dbg --cpu=ppc` | `[":generic_lib"]` |
+ 
+ `select()` serves as a placeholder for a value that will be chosen based on
+ *configuration conditions*, which are labels referencing [`config_setting`](/reference/be/general#config_setting)