Apply suggestions from docs review

Co-authored-by: Charlotte Wickham <[email protected]>

Author: gordonwoodhull

docs/authoring/brand.qmd

@@ -101,14 +101,12 @@ brand:
 ---
 ```
 
-Light and dark brands can also be specifieds in a project:
+Light and dark brands can also be specified at the project-level:
 
 ```{.yaml filename="_quarto.yml"}
----
 brand:
   light: light-brand.yml
   dark: dark-brand.yml
----
 ```
 
 ## Brand Elements
@@ -447,7 +445,7 @@ Beyond the automatic application of your brand file, you can also directly acces
 
 Some values from the `_brand.yml` configuration file can be accessed via the `brand` shortcode. In particular, you can access colors and logos by name:
 
--   Use `{{{< brand color COLOR_NAME BRAND_MODE >}}}` to return the brand color named `COLOR_NAME` as a string. Provide `dark` for `BRAND_MODE` in order to return the color from the [dark brand](#dark-brand); otherwise the light brand will be used.
+-   Use `{{{< brand color COLOR_NAME BRAND_MODE >}}}` to return the brand color named `COLOR_NAME` as a string. The `BRAND_MODE` is optional and defaults to `light`. To return the color from the [dark brand](#dark-brand) use `dark`.
 -   Use `{{{< brand logo LOGO_NAME >}}}` to return the brand logo named `LOGO_NAME` as an image.
 
 For example, you could use the shortcode to place a brand image you've named `icon` in a dashboard sidebar: