Do copy (#34)

* chore: remove work folder

Improve awk script a bit to fix some syntax issues

* delete broken comments

* chore: fix comment syntax

* chore: remove trailing whitespace

Author: alexeagle

.gitignore

@@ -3,3 +3,4 @@
 __pycache__/
 .venv/
 .hugo_build.lock
+node_modules

about/faq.mdx

@@ -56,7 +56,7 @@ For our server code base, we use the following development workflow:
 
 Bazel is a cornerstone of this philosophy: since Bazel requires all dependencies to be fully specified, we can predict which programs and tests are affected by a change, and vet them before submission.
 
-More background on the development process at Google can be found on the [eng tools blog](http://google-engtools.blogspot.com/){: .external}.
+More background on the development process at Google can be found on the [eng tools blog](http://google-engtools.blogspot.com/).
 
 ## Why did you open up Bazel?
 
@@ -70,8 +70,8 @@ Building software should be fun and easy. Slow and unpredictable builds take the
 
 ## Can I see examples?
 
-Yes; see a [simple example](https://github.com/bazelbuild/bazel/blob/master/examples/cpp/BUILD){: .external}
-or read the [Bazel source code](https://github.com/bazelbuild/bazel/blob/master/src/BUILD){: .external} for a more complex example.
+Yes; see a [simple example](https://github.com/bazelbuild/bazel/blob/master/examples/cpp/BUILD)
+or read the [Bazel source code](https://github.com/bazelbuild/bazel/blob/master/src/BUILD) for a more complex example.
 
 
 ## What is Bazel best at?
@@ -127,7 +127,7 @@ Bazel has conventions for structuring more complex programs, for example, a Java
 
 ## Can I build Docker images with Bazel?
 
-Yes, you can use our [Docker rules](https://github.com/bazelbuild/rules_docker){: .external} to build reproducible Docker images.
+Yes, you can use our [Docker rules](https://github.com/bazelbuild/rules_docker) to build reproducible Docker images.
 
 ## Will Bazel make my builds reproducible automatically?
 
@@ -140,15 +140,15 @@ For Java and C++ binaries, yes, assuming you do not change the toolchain. If you
 
 ## Do you have binary releases?
 
-Yes, you can find the latest [release binaries](https://github.com/bazelbuild/bazel/releases/latest){: .external} and review our [release policy](/release/)
+Yes, you can find the latest [release binaries](https://github.com/bazelbuild/bazel/releases/latest) and review our [release policy](/release/)
 
 ## I use Eclipse/IntelliJ/XCode. How does Bazel interoperate with IDEs?
 
 For IntelliJ, check out the [IntelliJ with Bazel plugin](https://ij.bazel.build/).
 
 For XCode, check out [Tulsi](http://tulsi.bazel.build/).
 
-For Eclipse, check out [E4B plugin](https://github.com/bazelbuild/e4b){: .external}.
+For Eclipse, check out [E4B plugin](https://github.com/bazelbuild/e4b).
 
 For other IDEs, check out the [blog post](https://blog.bazel.build/2016/06/10/ide-support.html) on how these plugins work.
 
@@ -164,7 +164,7 @@ See our [Roadmaps](/about/roadmap).
 
 ## Can I use Bazel for my INSERT LANGUAGE HERE project?
 
-Bazel is extensible. Anyone can add support for new languages. Many languages are supported: see the [build encyclopedia](/reference/be/overview) for a list of recommendations and [awesomebazel.com](https://awesomebazel.com/){: .external} for a more comprehensive list.
+Bazel is extensible. Anyone can add support for new languages. Many languages are supported: see the [build encyclopedia](/reference/be/overview) for a list of recommendations and [awesomebazel.com](https://awesomebazel.com/) for a more comprehensive list.
 
 If you would like to develop extensions or learn how they work, see the documentation for [extending Bazel](/extending/concepts).
 
@@ -195,7 +195,7 @@ We are reachable at bazel-discuss@googlegroups.com.
 
 ## Where do I report bugs?
 
-Open an issue [on GitHub](https://github.com/bazelbuild/bazel/issues){: .external}.
+Open an issue [on GitHub](https://github.com/bazelbuild/bazel/issues).
 
 ## What’s up with the word “Blaze” in the codebase?
 

about/intro.mdx

@@ -10,7 +10,7 @@ It uses a human-readable, high-level build language. Bazel supports projects in
 multiple languages and builds outputs for multiple platforms. Bazel supports
 large codebases across multiple repositories, and large numbers of users.
 
-## Benefits {:#benefits}
+## Benefits
 
 Bazel offers the following advantages:
 
@@ -39,7 +39,7 @@ Bazel offers the following advantages:
     supported, and you can extend Bazel to support any other language or
     framework.
 
-## Using Bazel {:#using-bazel}
+## Using Bazel
 
 To build or test a project with Bazel, you typically do the following:
 
@@ -54,7 +54,7 @@ To build or test a project with Bazel, you typically do the following:
 
     You write your `BUILD` file by declaring build targets using
     [Starlark](/rules/language), a domain-specific language. (See example
-    [here](https://github.com/bazelbuild/bazel/blob/master/examples/cpp/BUILD){: .external}.)
+    [here](https://github.com/bazelbuild/bazel/blob/master/examples/cpp/BUILD).)
 
     A build target specifies a set of input artifacts that Bazel will build plus
     their dependencies, the build rule Bazel will use to build it, and options
@@ -72,7 +72,7 @@ In addition to building, you can also use Bazel to run
 [tests](/reference/test-encyclopedia) and [query](/query/guide) the build
 to trace dependencies in your code.
 
-## Bazel build process {:#bazel-build-process}
+## Bazel build process
 
 When running a build or a test, Bazel does the following:
 
@@ -92,7 +92,7 @@ correctness, you can set up Bazel to run builds and tests
 [hermetically](/basics/hermeticity) through sandboxing, minimizing skew
 and maximizing [reproducibility](/run/build#correct-incremental-rebuilds).
 
-### Action graph {:#action-graph}
+### Action graph
 
 The action graph represents the build artifacts, the relationships between them,
 and the build actions that Bazel will perform. Thanks to this graph, Bazel can
@@ -101,7 +101,7 @@ file content as well as changes to actions, such as build or test commands, and
 know what build work has previously been done. The graph also enables you to
 easily [trace dependencies](/query/guide) in your code.
 
-## Getting started tutorials {:#getting-started-tutorials}
+## Getting started tutorials
 
 To get started with Bazel, see [Getting Started](/start/) or jump
 directly to the Bazel tutorials:

about/vision.mdx

@@ -46,7 +46,7 @@ Bazel's abstraction layer — instructions specific to languages, platforms, and
 toolchains implemented in a simple extensibility language — allows it to be
 easily applied to any context.
 
-## Bazel core competencies {:#bazel-core-competencies}
+## Bazel core competencies
 
 1.  Bazel supports **multi-language, multi-platform** builds and tests. You can
     run a single command to build and test your entire source tree, no matter
@@ -63,7 +63,7 @@ easily applied to any context.
     possible. Bazel interfaces with de-facto standard tools for a given
     language/platform.
 
-## Serving language communities {:#language-communities}
+## Serving language communities
 
 Software engineering evolves in the context of language communities — typically,
 self-organizing groups of people who use common tools and practices.
@@ -74,7 +74,7 @@ available that integrate with the workflows and conventions of that community.
 Bazel is committed to be extensible and open, and to support good rulesets for
 any language.
 
-###  Requirements of a good ruleset {:#ruleset-requirements}
+###  Requirements of a good ruleset
 
 1.  The rules need to support efficient **building and testing** for the
     language, including code coverage.

about/why.mdx

@@ -10,7 +10,7 @@ build tool with [integrated testing](#integrated-testing) that supports multiple
 [languages](#multi-language), [repositories](#multi-repository), and
 [platforms](#multi-platform) in an industry-leading [ecosystem](#ecosystem).
 
-## Bazel is fast {:#fast}
+## Bazel is fast
 
 Bazel knows exactly what input files each build command needs, avoiding
 unnecessary work by re-running only when the set of input files have
@@ -23,7 +23,7 @@ This is supported by multiple caching layers, in memory, on disk and on the
 remote build farm, if available. At Google, we routinely achieve cache hit rates
 north of 99%.
 
-## Bazel is correct {:#correct}
+## Bazel is correct
 
 Bazel ensures that your binaries are built *only* from your own
 source code. Bazel actions run in individual sandboxes and Bazel tracks
@@ -35,7 +35,7 @@ by bit.
 Say goodbye to endless `make clean` invocations and to chasing phantom bugs
 that were in fact resolved in source code that never got built.
 
-## Bazel is extensible {:#extensible}
+## Bazel is extensible
 
 Harness the full power of Bazel by writing your own rules and macros to
 customize Bazel for your specific needs across a wide range of projects.
@@ -45,7 +45,7 @@ in-house programming language that's a subset of Python. Starlark makes
 rule-writing accessible to most developers, while also creating rules that can
 be used across the ecosystem.
 
-## Integrated testing {:#integrated-testing}
+## Integrated testing
 
 Bazel's [integrated test runner](/docs/user-manual#running-tests)
 knows and runs only those tests needing to be re-run, using remote execution
@@ -56,28 +56,28 @@ Bazel [provides facilities](/remote/bep) to upload test results to a central
 location, thereby facilitating efficient communication of test outcomes, be it
 on CI or by individual developers.
 
-## Multi-language support {:#multi-language}
+## Multi-language support
 
 Bazel supports many common programming languages including C++, Java,
 Kotlin, Python, Go, and Rust. You can build multiple binaries (for example,
 backend, web UI and mobile app) in the same Bazel invocation without being
 constrained to one language's idiomatic build tool.
 
-## Multi-repository support {:#multi-repository}
+## Multi-repository support
 
 Bazel can [gather source code from multiple locations](/external/overview): you
 don't need to vendor your dependencies (but you can!), you can instead point
 Bazel to the location of your source code or prebuilt artifacts (e.g. a git
 repository or Maven Central), and it takes care of the rest.
 
-## Multi-platform support {:#multi-platform}
+## Multi-platform support
 
 Bazel can simultaneously build projects for multiple platforms including Linux,
 macOS, Windows, and Android. It also provides powerful
 [cross-compilation capabilities](/extending/platforms) to build code for one
 platform while running the build on another.
 
-## Wide ecosystem {:#ecosystem}
+## Wide ecosystem
 
 [Industry leaders](/community/users) love Bazel, building a large
 community of developers who use and contribute to Bazel. Find a tools, services

advanced/performance/build-performance-metrics.mdx

@@ -24,7 +24,7 @@ how you can use these metrics to detect and fix build performance issues.
 
 There are a few main ways to extract metrics from your Bazel builds, namely:
 
-## Build Event Protocol (BEP) {:#build-event-protocol}
+## Build Event Protocol (BEP)
 
 Bazel outputs a variety of protocol buffers
 [`build_event_stream.proto`](https://github.com/bazelbuild/bazel/blob/master/src/main/java/com/google/devtools/build/lib/buildeventstream/proto/build_event_stream.proto)
@@ -33,7 +33,7 @@ can be aggregated by a backend specified by you. Depending on your use cases,
 you might decide to aggregate the metrics in various ways, but here we will go
 over some concepts and proto fields that would be useful in general to consider.
 
-## Bazel’s query / cquery / aquery commands {:#bazel-commands-query-cquery-aquery}
+## Bazel’s query / cquery / aquery commands
 
 Bazel provides 3 different query modes ([query](/query/quickstart),
 [cquery](/query/cquery) and [aquery](/query/aquery)) that allow users
@@ -42,14 +42,14 @@ respectively. The query language provides a
 [suite of functions](/query/language#functions) usable across the different
 query modes, that allows you to customize your queries according to your needs.
 
-## JSON Trace Profiles {:#json-trace-profiles}
+## JSON Trace Profiles
 
 For every build-like Bazel invocation, Bazel writes a trace profile in JSON
 format. The [JSON trace profile](/advanced/performance/json-trace-profile) can
 be very useful to quickly understand what Bazel spent time on during the
 invocation.
 
-## Execution Log {:#execution-log}
+## Execution Log
 
 The [execution log](/remote/cache-remote) can help you to troubleshoot and fix
 missing remote cache hits due to machine and environment differences or
@@ -61,7 +61,7 @@ make comparisons between local and remote machine performance or to find out
 which part of the spawn execution is consistently slower than expected (for
 example due to queuing).
 
-## Execution Graph Log {:#execution-graph-log}
+## Execution Graph Log
 
 While the JSON trace profile contains the critical path information, sometimes
 you need additional information on the dependency graph of the executed actions.
@@ -77,7 +77,7 @@ by removing a particular node from the execution graph.
 The data helps you predict the impact of changes to the build and action graph
 before you actually do them.
 
-## Benchmarking with bazel-bench {:#bazel-bench}
+## Benchmarking with bazel-bench
 
 [Bazel bench](https://github.com/bazelbuild/bazel-bench) is a
 benchmarking tool for Git projects to benchmark build performance in the

advanced/performance/iteration-speed.mdx

@@ -9,7 +9,7 @@ title: 'Optimize Iteration Speed'
 This page describes how to optimize Bazel's build performance when running Bazel
 repeatedly.
 
-## Bazel's Runtime State {:#bazel-runtime-state}
+## Bazel's Runtime State
 
 A Bazel invocation involves several interacting parts.
 
@@ -34,7 +34,7 @@ A Bazel invocation involves several interacting parts.
 
 *   The result of the Bazel invocation is made available in the output tree.
 
-## Running Bazel Iteratively {:#run-iteratively}
+## Running Bazel Iteratively
 
 In a typical developer workflow, it is common to build (or run) a piece of code
 repeatedly, often at a very high frequency (e.g. to resolve some compilation
@@ -66,7 +66,7 @@ cache can be kept locally
 [remotely](https://bazel.build/remote/caching). The cache can be shared among
 Bazel servers, and indeed among developers.
 
-## Avoid discarding the analysis cache {:#avoid-discarding-cache}
+## Avoid discarding the analysis cache
 
 Bazel will print a warning if either the analysis cache was discarded or the
 server was restarted. Either of these should be avoided during iterative use:

advanced/performance/json-trace-profile.mdx

@@ -54,10 +54,10 @@ You can use these keyboard controls to navigate:
 ### Bazel Invocation Analyzer
 
 The open-source
-[Bazel Invocation Analyzer](https://github.com/EngFlow/bazel_invocation_analyzer){: .external}
+[Bazel Invocation Analyzer](https://github.com/EngFlow/bazel_invocation_analyzer)
 consumes a profile format and prints suggestions on how to improve
 the build’s performance. This analysis can be performed using its CLI or on
-[https://analyzer.engflow.com](https://analyzer.engflow.com){: .external}.
+[https://analyzer.engflow.com](https://analyzer.engflow.com).
 
 ### `jq`
 
@@ -77,7 +77,7 @@ $ zcat $(../bazel-6.0.0rc1-linux-x86_64 info output_base)/command.profile.gz | j
 [...]
 ```
 
-## Profile information {:#profile-information}
+## Profile information
 
 The profile contains multiple rows. Usually the bulk of rows represent Bazel
 threads and their corresponding events, but some special rows are also included.
@@ -100,7 +100,7 @@ Figure 1 shows a profile created with Bazel v5.3.1 and includes these rows:
 *   `Garbage Collector`: Displays minor and major Garbage Collection (GC)
     pauses.
 
-## Common performance issues {:#common-performance-issues}
+## Common performance issues
 
 When analyzing performance profiles, look for:
 
@@ -118,7 +118,7 @@ When analyzing performance profiles, look for:
     or Bazel itself to introduce more parallelism. This can also happen when
     there is an unusual amount of GC.
 
-## Profile file format {:#profile-file-format}
+## Profile file format
 
 The top-level object contains metadata (`otherData`) and the actual tracing data
 (`traceEvents`). The metadata contains extra info, for example the invocation ID
@@ -157,4 +157,4 @@ each other; pass
 if you would like to prevent event merging.
 
 See also the
-[Chrome Trace Event Format Specification](https://docs.google.com/document/d/1CvAClvFfyA5R-PhYUmn5OOQtYMH4h6I0nSsKchNAySU/preview){: .external}.
+[Chrome Trace Event Format Specification](https://docs.google.com/document/d/1CvAClvFfyA5R-PhYUmn5OOQtYMH4h6I0nSsKchNAySU/preview).

advanced/performance/memory.mdx

@@ -8,14 +8,14 @@ title: 'Optimize Memory'
 
 This page describes how to limit and reduce the memory Bazel uses.
 
-## Running Bazel with Limited RAM {:#running-bazel}
+## Running Bazel with Limited RAM
 
 In certain situations, you may want Bazel to use minimal memory. You can set the
 maximum heap via the startup flag
 [`--host_jvm_args`](/docs/user-manual#host-jvm-args),
 like `--host_jvm_args=-Xmx2g`.
 
-### Trade incremental build speeds for memory {:#trade-incremental}
+### Trade incremental build speeds for memory
 
 If your builds are too big, Bazel may throw an `OutOfMemoryError` (OOM) when
 it doesn't have enough memory. You can make Bazel use less memory, at the cost
@@ -42,7 +42,7 @@ prevent most re-execution).
  incremental builds have to build from scratch (except for the on-disk action
  cache). Alone, it does not affect the high-water mark of the current build.
 
-### Trade build flexibility for memory with Skyfocus (Experimental) {:#trade-flexibility}
+### Trade build flexibility for memory with Skyfocus (Experimental)
 
 If you want to make Bazel use less memory *and* retain incremental build speeds,
 you can tell Bazel the working set of files that you will be modifying, and
@@ -91,7 +91,7 @@ and incremental builds to handle changes to files under `dir1`, `dir2`, and
 `dir3/subdir` will retain their fast speeds, with the tradeoff that Bazel cannot
 rebuild changed files outside of these directories.
 
-## Memory Profiling {:#memory-profiling}
+## Memory Profiling
 
 Bazel comes with a built-in memory profiler that can help you check your rule’s
 memory use. Read more about this process on the