Standardize site-wide capitalization
- Use **Sentence casing** for all titles and section headers
- Words after a **":"** remain capitalized
- A few section name rewrites for shorter length, better readability
Source: https://developers.google.com/style/capitalization#capitalization-in-titles-and-headings_1
Serves https://github.com/bazelbuild/bazel/issues/10794
Closes #10827.
PiperOrigin-RevId: 296278672
diff --git a/site/docs/configurable-attributes.md b/site/docs/configurable-attributes.md
index 4ecf439..8583f5d 100644
--- a/site/docs/configurable-attributes.md
+++ b/site/docs/configurable-attributes.md
@@ -1,25 +1,25 @@
---
layout: documentation
-title: Configurable Build Attributes
+title: Configurable build attributes
---
-# Configurable Build Attributes
+# Configurable build attributes
### Contents
* [Example](#example)
-* [Configuration Conditions](#configuration-conditions)
+* [Configuration conditions](#configuration-conditions)
* [Defaults](#defaults)
-* [Custom Keys](#custom-keys)
+* [Custom keys](#custom-keys)
* [Platforms](#platforms)
-* [Short Keys](#short-keys)
-* [Multiple Selects](#multiple-selects)
-* [OR Chaining](#or-chaining)
+* [Short keys](#short-keys)
+* [Multiple `select` functions](#multiple-select-functions)
+* [OR chaining](#or-chaining)
* [selects.with_or](#selects-with-or)
* [selects.config_setting_group](#selects-config-setting-or-group)
-* [AND Chaining](#and-chaining)
-* [Custom Error Messages](#custom-error-messages)
-* [Rules Compatibility](#rules)
-* [Bazel Query and Cquery](#query)
+* [AND chaining](#and-chaining)
+* [Custom error messages](#custom-error-messages)
+* [Rules compatibility](#rules)
+* [Bazel query and query](#query)
* [FAQ](#faq)
* [Why doesn't select() work in macros?](#macros-select)
* [Why does select() always return true?](#boolean-select)
@@ -116,7 +116,7 @@
but not within the attribute that causes the change. That is, a `select` in the
`tools` attribute of a `genrule` will work the same as a `select` in the `srcs`.
-## Configuration Conditions
+## Configuration conditions
Each key in a configurable attribute is a label reference to a
[`config_setting`](be/general.html#config_setting) target. This is just a
@@ -195,7 +195,7 @@
`select()` can include a [`no_match_error`](#custom-error-messages) for custom
failure messages.
-## Custom Keys
+## Custom keys
Since `config_setting` currently only supports built-in Bazel flags, the level
of custom conditioning it can support is limited. For example, there's no Bazel
@@ -327,7 +327,7 @@
Platforms are still under development. See the [documentation](platforms.html)
and [roadmap](https://bazel.build/roadmaps/platforms.html) for details.
-## Short Keys
+## Short keys
Since configuration keys are target labels, their names can get long and
unwieldy. This can be mitigated with local variable definitions:
@@ -409,7 +409,7 @@
)
```
-## Multiple Selects
+## Multiple `select` functions
`select` can appear multiple times in the same attribute:
@@ -456,7 +456,7 @@
If you just need a `select` to match when multiple conditions match, see [AND
chaining](#and-chaining).
-## OR Chaining
+## OR chaining
Consider the following:
@@ -566,7 +566,7 @@
"specialization" of the other. See [select()](be/functions.html#select)
documentation for details.
-## And Chaining
+## And chaining
If you need a `select` path to match when multiple conditions match, use the
[Skylib](https://github.com/bazelbuild/bazel-skylib) macro
@@ -603,7 +603,7 @@
directly inside a `select`: you have to explicitly declare the
`config_setting_group`.
-## Custom Error Messages
+## Custom error messages
By default, when no condition matches, the owning target fails with the error:
@@ -636,7 +636,7 @@
build with an Android or Windows toolchain
```
-## <a name="rules"></a>Rules Compatibility
+## <a name="rules"></a>Rules compatibility
Rule implementations receive the *resolved values* of configurable
attributes. For example, given:
@@ -683,7 +683,7 @@
technically feasible, lack a coherent UI. Further design is necessary to change
this.
-## <a name="query"></a>Bazel Query and Cquery
+## <a name="query"></a>Bazel query and cquery
Bazel `query` operates over Bazel's [loading phase](
user-manual.html#loading-phase). This means it doesn't know what command line
flags will be applied to a target since those flags aren't evaluated until later
