Skip to content

Commit d67b13a

Browse files
fweikertcopybara-github
authored andcommitted
Bazel Docs: Remove all DevSite tags from new .mdx docs.
GCLI created a Python script in unknown commit that did all the heavy lifting. This is a breaking change, but unfortunately Mintlify isn't going to support custom heading IDs in the near future. Workarounds are being tracked in bazel-contrib/bazel-docs#252 Our best course of action is to fix the parsing errors by removing the custom IDs, then proceed with the workarounds. PiperOrigin-RevId: 879883162 Change-Id: I328765485bf3dacf4118357083488abb796ba2bc
1 parent dd27de7 commit d67b13a

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

51 files changed

+1242
-1242
lines changed

docs/community/users.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -51,7 +51,7 @@ ASML is an innovation leader in the semiconductor industry. We provide chipmaker
5151
with everything they need – hardware, software and services – to mass produce
5252
patterns on silicon through lithography.
5353

54-
### [Augment Code](https://augmentcode.com){: .external}
54+
### [Augment Code](https://augmentcode.com)
5555

5656
Augment Code is the first Developer AI for teams.
5757
Every Augment feature is context aware. Every suggestion, completion, and

docs/concepts/build-files.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ For simplicity's sake, the documentation refers to these files simply as `BUILD`
1717
files.
1818

1919
`BUILD` files are evaluated using an imperative language,
20-
[Starlark](https://github.com/bazelbuild/starlark/){: .external}.
20+
[Starlark](https://github.com/bazelbuild/starlark/).
2121

2222
They are interpreted as a sequential list of statements.
2323

docs/contribute/search.mdx

Lines changed: 18 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -2,14 +2,14 @@
22
title: 'Searching the codebase'
33
---
44

5-
## Product overview {:#product-overview}
5+
## Product overview
66

77
Bazel's [code search and source browsing interface](https://source.bazel.build)
88
is a web-based tool for browsing Bazel source code repositories. You can
99
use these features to navigate among different repositories, branches, and
1010
files. You can also view history, diffs, and blame information.
1111

12-
## Getting started {:#getting-started}
12+
## Getting started
1313

1414
Note: For the best experience, use the latest version of Chrome, Safari, or
1515
Firefox.
@@ -29,9 +29,9 @@ commit.
2929
At the top of the screen is a search box. You can use this box to search for
3030
specific files and code.
3131

32-
## Working with repositories {:#working-with-repositories}
32+
## Working with repositories
3333

34-
### Opening a repository {:#opening-a-repository}
34+
### Opening a repository
3535

3636
To open a repository, click its name from the main screen.
3737

@@ -41,11 +41,11 @@ repository and allows you to move quickly to another location such as another
4141
repository, or another location within a repository, such as a file, branch, or
4242
commit.
4343

44-
### Switch repositories {:#switch-repositories}
44+
### Switch repositories
4545

4646
To switch to a different repository, select the repository from the Breadcrumb toolbar.
4747

48-
### View a repository at a specific commit {:#view-a-repository-at-a-specific-commit}
48+
### View a repository at a specific commit
4949

5050
To view a repository at a specific commit:
5151

@@ -56,7 +56,7 @@ To view a repository at a specific commit:
5656

5757
The interface now shows the repository as it existed at that commit.
5858

59-
### Open a branch, commit, or tag {:#open-a-branch-commit-or-tag}
59+
### Open a branch, commit, or tag
6060

6161
By default, the code search and source browsing interface opens a repository to
6262
the default branch. To open a different branch, from the Breadcrumb toolbar,
@@ -72,7 +72,7 @@ branch using a branch name, a tag name, or through a search box.
7272
* To search for a branch, commit, or tag, select the corresponding item and
7373
type a search term in the search box.
7474

75-
## Working with files {:#working-with-files}
75+
## Working with files
7676

7777
When you select a repository from the main screen, the screen changes to display
7878
a view of that repository. If a README file exists, its contents appear in the
@@ -90,13 +90,13 @@ three components:
9090
* A **File path** box, which displays the name of the current file or folder
9191
and its corresponding path
9292

93-
### Open a file {:#open-a-file}
93+
### Open a file
9494

9595
You can open a file by browsing to its directory and selecting it. The view of
9696
the repository updates to show the contents of the file in the file pane, and
9797
its location in the repository in the tree pane.
9898

99-
### View file changes {:#view-file-changes}
99+
### View file changes
100100

101101
To view file changes:
102102

@@ -105,15 +105,15 @@ To view file changes:
105105

106106
The file pane updates to display who made changes to the file and when.
107107

108-
### View change history {:#view-change-history}
108+
### View change history
109109

110110
To view the change history of a file:
111111

112112
1. From the view of the repository, select the file.
113113
1. Click **HISTORY**, located in the upper-right corner.
114114
The **Change history** pane appears, showing the commits for this file.
115115

116-
### View code reviews {:#view-code-reviews}
116+
### View code reviews
117117

118118
For Gerrit code reviews, you can open the tool directly from the Change History pane.
119119

@@ -128,7 +128,7 @@ To view the code review for a file:
128128

129129
The Gerrit Code Review tool opens in a new browser window.
130130

131-
### Open a file at a specific commit {:#open-a-file-at-a-specific-commit}
131+
### Open a file at a specific commit
132132

133133
To open a file at a specific commit:
134134

@@ -138,7 +138,7 @@ To open a file at a specific commit:
138138
1. Hover over a commit. A **VIEW** button appears.
139139
1. Click the **VIEW** button.
140140

141-
### Compare a file to a different commit {:#compare-a-file-to-a-different-commit}
141+
### Compare a file to a different commit
142142

143143
To compare a file at a different commit:
144144

@@ -157,7 +157,7 @@ To change either file, hover over the commit in the Change History pane. Then,
157157
click either the **Left** or **Right** button to have the open the commit on the
158158
left or right side of the diff.
159159

160-
### Browsing cross references {:#browsing-cross-references}
160+
### Browsing cross references
161161

162162
Another way to browse source repositories is through the use of cross
163163
references. These references appear automatically as hyperlinks within a given
@@ -188,12 +188,12 @@ You can continue to browse cross references using the Cross Reference pane, just
188188
as you can in the File pane. When you do, the pane displays a breadcrumb trail,
189189
which you can use to navigate between different cross references.
190190

191-
## Searching for code {:#search}
191+
## Searching for code
192192

193193
You can search for specific files or code snippets using the search box located
194194
at the top of the screen. Searches are always against the default branch.
195195

196-
All searches use [RE2 regular expressions](https://github.com/google/re2/wiki/Syntax){: .external}
196+
All searches use [RE2 regular expressions](https://github.com/google/re2/wiki/Syntax)
197197
by default. If you do not want to use regular expressions, enclose your search
198198
in double quotes ( " ).
199199

@@ -270,7 +270,7 @@ f:</td>
270270
</tbody>
271271
</table>
272272

273-
## Additional Support {:#additional-support}
273+
## Additional Support
274274

275275
To report an issue, click the **Feedback** button that appears in the top
276276
right-hand corner of the screen and enter your feedback in the provided form.

docs/docs/android-instrumentation-test.mdx

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -56,7 +56,7 @@ bazel info release
5656
```
5757
This results in output similar to the following:
5858

59-
```none {:.devsite-disable-click-to-copy}
59+
```none
6060
release 4.1.0
6161
```
6262

@@ -74,7 +74,7 @@ apt-get install cpu-checker && kvm-ok
7474

7575
If it prints the following message, you have the correct configuration:
7676

77-
```none {:.devsite-disable-click-to-copy}
77+
```none
7878
INFO: /dev/kvm exists
7979
KVM acceleration can be used
8080
```
@@ -95,7 +95,7 @@ which Xvfb
9595
```
9696
The output is the following:
9797

98-
```{:.devsite-disable-click-to-copy}
98+
```
9999
/usr/bin/Xvfb
100100
```
101101

docs/docs/cc-toolchain-config-reference.mdx

Lines changed: 21 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: 'C++ Toolchain Configuration'
33
---
44

5-
## Overview {:#overview}
5+
## Overview
66

77
To invoke the compiler with the right options, Bazel needs some knowledge about
88
the compiler internals, such as include directories and important flags.
@@ -35,7 +35,7 @@ that provides the `CcToolchainConfigInfo` and you need to point the
3535
You can create the `CcToolchainConfigInfo` by calling
3636
[`cc_common.create_cc_toolchain_config_info()`](/rules/lib/toplevel/cc_common#create_cc_toolchain_config_info).
3737
You can find Starlark constructors for all structs you'll need in the process in
38-
[`@rules_cc//cc:cc_toolchain_config_lib.bzl`](https://github.com/bazelbuild/rules_cc/blob/master/cc/cc_toolchain_config_lib.bzl){: .external}.
38+
[`@rules_cc//cc:cc_toolchain_config_lib.bzl`](https://github.com/bazelbuild/rules_cc/blob/master/cc/cc_toolchain_config_lib.bzl).
3939

4040
When a C++ target enters the analysis phase, Bazel selects the appropriate
4141
`cc_toolchain` target based on the `BUILD` file, and obtains the
@@ -59,7 +59,7 @@ The artifacts to be shipped to the sandbox are declared in the `cc_toolchain`
5959
target. For example, with the `cc_toolchain.linker_files` attribute you can
6060
specify the linker binary and toolchain libraries to ship into the sandbox.
6161

62-
## Toolchain selection {:#toolchain-selection}
62+
## Toolchain selection
6363

6464
The toolchain selection logic operates as follows:
6565

@@ -93,7 +93,7 @@ fully fledged C++ features in Bazel without modifying the
9393
Bazel binary. C++ rules support multiple unique actions documented in detail
9494
[in the Bazel source code](https://source.bazel.build/bazel/+/4f547a7ea86df80e4c76145ffdbb0c8b75ba3afa:tools/build_defs/cc/action_names.bzl).
9595

96-
## Features {:#features}
96+
## Features
9797

9898
A feature is an entity that requires command-line flags, actions,
9999
constraints on the execution environment, or dependency alterations. A feature
@@ -121,7 +121,7 @@ A feature is enabled in one of the following ways:
121121
Features can have interdependencies, depend on command line flags, `BUILD` file
122122
settings, and other variables.
123123

124-
### Feature relationships {:#feature-relationships}
124+
### Feature relationships
125125

126126
Dependencies are typically managed directly with Bazel, which simply enforces
127127
the requirements and manages conflicts intrinsic to the nature of the features
@@ -195,7 +195,7 @@ support and expansion. These are:
195195
</tr>
196196
</table>
197197

198-
## Actions {:#actions}
198+
## Actions
199199

200200
Actions provide the flexibility to modify the circumstances under
201201
which an action executes without assuming how the action will be run. An
@@ -216,7 +216,7 @@ that implements an action (such as `CppCompileAction`). In particular, the
216216
"assembler actions" and "compiler actions" in the table below are
217217
`CppCompileAction`, while the link actions are `CppLinkAction`.
218218

219-
### Assembler actions {:#assembler-actions}
219+
### Assembler actions
220220

221221
<table>
222222
<col width="300">
@@ -241,7 +241,7 @@ that implements an action (such as `CppCompileAction`). In particular, the
241241
</tr>
242242
</table>
243243

244-
### Compiler actions {:#compiler-actions}
244+
### Compiler actions
245245

246246
<table>
247247
<col width="300">
@@ -280,7 +280,7 @@ that implements an action (such as `CppCompileAction`). In particular, the
280280
</tr>
281281
</table>
282282

283-
### Link actions {:#link-actions}
283+
### Link actions
284284

285285
<table>
286286
<col width="300">
@@ -311,7 +311,7 @@ that implements an action (such as `CppCompileAction`). In particular, the
311311
</tr>
312312
</table>
313313

314-
### AR actions {:#ar-actions}
314+
### AR actions
315315

316316
AR actions assemble object files into archive libraries (`.a` files) via `ar`
317317
and encode some semantics into the name.
@@ -333,7 +333,7 @@ and encode some semantics into the name.
333333
</tr>
334334
</table>
335335

336-
### LTO actions {:#lto-actions}
336+
### LTO actions
337337

338338
<table>
339339
<col width="300">
@@ -358,7 +358,7 @@ and encode some semantics into the name.
358358
</tr>
359359
</table>
360360

361-
## Using action_config {:#using-action-config}
361+
## Using action_config
362362

363363
The `action_config` is a Starlark struct that describes a Bazel
364364
action by specifying the tool (binary) to invoke during the action and sets of
@@ -424,7 +424,7 @@ within the same toolchain. This prevents ambiguity in tool paths
424424
and enforces the intention behind `action_config` - that an action's properties
425425
are clearly described in a single place in the toolchain.
426426

427-
### Using tool constructor {:#using-tool-constructor}
427+
### Using tool constructor
428428

429429
An`action_config` can specify a set of tools via its `tools` parameter.
430430
The `tool()` constructor takes in the following parameters:
@@ -461,7 +461,7 @@ with a `with_feature` set matching the feature configuration is found
461461
for more information). You should end your tool lists with a default
462462
tool that corresponds to an empty feature configuration.
463463

464-
### Example usage {:#example-usage}
464+
### Example usage
465465

466466
Features and actions can be used together to implement Bazel actions
467467
with diverse cross-platform semantics. For example, debug symbol generation on
@@ -553,7 +553,7 @@ follows:
553553
),
554554
]
555555

556-
### Flag groups {:#flag-groups}
556+
### Flag groups
557557

558558
`CcToolchainConfigInfo` allows you to bundle flags into groups that serve a
559559
specific purpose. You can specify a flag within using pre-defined variables
@@ -622,7 +622,7 @@ example:
622622
],
623623
)
624624

625-
### Conditional expansion {:#conditional-expansion}
625+
### Conditional expansion
626626

627627
Flag groups support conditional expansion based on the presence of a particular
628628
variable or its field using the `expand_if_available`, `expand_if_not_available`,
@@ -654,12 +654,12 @@ Note: The `--whole_archive` and `--no_whole_archive` options are added to
654654
the build command only when a currently iterated library has an
655655
`is_whole_archive` field.
656656

657-
## CcToolchainConfigInfo reference {:#cctoolchainconfiginfo-reference}
657+
## CcToolchainConfigInfo reference
658658

659659
This section provides a reference of build variables, features, and other
660660
information required to successfully configure C++ rules.
661661

662-
### CcToolchainConfigInfo build variables {:#cctoolchainconfiginfo-build-variables}
662+
### CcToolchainConfigInfo build variables
663663

664664
The following is a reference of `CcToolchainConfigInfo` build variables.
665665

@@ -988,7 +988,7 @@ Note: The **Action** column indicates the relevant action type, if applicable.
988988
</tr>
989989
</table>
990990

991-
### Well-known features {:#wellknown-features}
991+
### Well-known features
992992

993993
The following is a reference of features and their activation
994994
conditions.
@@ -1092,7 +1092,7 @@ conditions.
10921092
</tr>
10931093
</table>
10941094

1095-
#### Legacy features patching logic {:#legacy-features-patching-logic}
1095+
#### Legacy features patching logic
10961096

10971097
<p>
10981098
Bazel applies the following changes to the toolchain's features for backwards
@@ -1142,7 +1142,7 @@ conditions.
11421142
</p>
11431143

11441144
This is a long list of features. The plan is to get rid of them once
1145-
[Crosstool in Starlark](https://github.com/bazelbuild/bazel/issues/5380){: .external} is
1145+
[Crosstool in Starlark](https://github.com/bazelbuild/bazel/issues/5380) is
11461146
done. For the curious reader see the implementation in
11471147
[CppActionConfigs](https://source.bazel.build/bazel/+/master:src/main/java/com/google/devtools/build/lib/rules/cpp/CppActionConfigs.java?q=cppactionconfigs&ss=bazel),
11481148
and for production toolchains consider adding `no_legacy_features` to make

0 commit comments

Comments
 (0)