make some edits to doc

Author: cderv

docs/authoring/diagrams.qmd

@@ -201,15 +201,15 @@ format:
 Valid values for `mermaid-format` include `js`, `png`, and `svg`,
 
 ::: callout-warning
-## SVG Format Limitations with PDF Output
+## SVG Format Limitations with PDF Output through LaTeX
 
-When rendering to PDF or LaTeX-based formats, `mermaid-format: svg` requires additional tooling and may have rendering issues:
+When rendering to LaTeX-based formats, `mermaid-format: svg` requires additional tooling and may have rendering issues:
 
-- **Requires installation:** `rsvg-convert` must be available in your system PATH
+- **Requires installation:** `rsvg-convert` must be available in your system PATH for Quarto to convert SVG to PDF to include in LaTeX.
 - **Potential rendering issues:** Text clipping in diagrams with multi-line labels
-- **Recommended:** Use default `mermaid-format: png` for PDF output
+- **Recommended:** Keep default `mermaid-format: png` for PDF output with LaTeX.
 
-For installation instructions, see [SVG Images](/docs/output-formats/pdf-basics.qmd#svg-images).
+For more details, including installation instructions, see [SVG Images](/docs/output-formats/pdf-basics.qmd#svg-images).
 :::
 
 ## Mermaid Themes {#mermaid-theming}

docs/output-formats/pdf-basics.qmd

@@ -223,6 +223,7 @@ You can learn more about installing `librsvg`{spellcheck="false"} (which provide
 -   On MacOS, use Homebrew: `brew install librsvg`{spellcheck="false"}
 -   On Linux, tarballs available at: <https://download.gnome.org/sources/librsvg/>
 -   On Windows, install using chocolatey: `choco install rsvg-convert`{spellcheck="false"} or using Scoop:
+    
     ````powershell
     # scoop bucket add r-bucket https://github.com/cderv/r-bucket.git
     scoop install rsvg-convert