From c4d7faf5271db65408a68a2da80b965a2de44363 Mon Sep 17 00:00:00 2001
From: PgBiel <9021226+PgBiel@users.noreply.github.com>
Date: Tue, 4 Mar 2025 17:17:32 -0300
Subject: [PATCH] laurenz review adjustments

---
 crates/typst-library/src/text/raw.rs | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

diff --git a/crates/typst-library/src/text/raw.rs b/crates/typst-library/src/text/raw.rs
index 3dbd1d2da..3cec14f2e 100644
--- a/crates/typst-library/src/text/raw.rs
+++ b/crates/typst-library/src/text/raw.rs
@@ -63,17 +63,20 @@ use crate::World;
 /// ```
 ///
 /// # Styling
-///
 /// By default, the `raw` element uses the `DejaVu Sans Mono` font, available
 /// by default in Typst, with a smaller font size of `0.8em` (that is, 80% of
-/// the global font size). You can customize these properties with a show-set
-/// rule:
+/// the global font size). This is because monospace fonts tend to be visually
+/// larger than non-monospace fonts.
+///
+/// You can customize these properties with show-set rules:
 ///
 /// ````example
-/// // Switch to Cascadia Code for both inline and block raw.
+/// // Switch to Cascadia Code for
+/// // both inline and block raw.
 /// #show raw: set text(font: "Cascadia Code")
-/// // Make raw blocks 20% larger than normal text,
-/// // while keeping inline raw smaller than text.
+///
+/// // Make raw blocks 20% larger than their default size.
+/// // Keep inline raw at the same size.
 /// #show raw.where(block: true): set text(1.2em)
 ///
 /// Now using the `Cascadia Code` font for raw text.