Clarify brand replaces entire _brand.yml

Author: cwickham

docs/authoring/brand.qmd

@@ -80,16 +80,18 @@ Currently, the formats that support **brand.yml** are: `html`, `dashboard`, `rev
 To specify a brand, create a `_brand.yml` file in the root directory of your project. *Do you need a project? Do we reccommend a project? *
 Quarto will detect the presence of `_brand.yml` and automatically apply the brand to all documents of the supported formats in the project.
 
-You can also set, or override, brand settings in a document by specifying brand elements under the `brand` option:
+You can also set brand options in a document by specifying brand elements under the `brand` option:
 
 ```{.yaml filename="document.qmd"}
 ---
 brand:
   color:
-    background: "#ffffff"
+    background: "#eeeeee"
 ---
 ```
 
+If you set `brand` in a document header, it will replace the entire brand from `_brand.yml`.
+
 You can disable brand for a document by setting `brand` to `false`:
 
 ```{.yaml filename="document.qmd"}

docs/reference/metadata/brand.qmd

@@ -14,7 +14,7 @@ color:
   foreground: blue
 ```
 
-Alternatively you can set, or override, options in the document header under `brand`:
+You can also specify brand options in a document header under `brand`:
 
 ```{.yaml filename="document.qmd"}
 ---