From fa788bda2b2537906d6bf3788d46f0ca324c1b42 Mon Sep 17 00:00:00 2001
From: Nico Alba <nico.alba@netfoundry.io>
Date: Thu, 11 Jun 2026 18:09:28 +0000
Subject: [PATCH 1/2] fix wrapping for code ph

---
 docs-linter/.markdownlint.json           |  3 ++-
 docs-linter/.vale.ini                    |  1 +
 packages/docusaurus-theme/css/legacy.css | 10 ++++++++++
 3 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/docs-linter/.markdownlint.json b/docs-linter/.markdownlint.json
index 29e57bf5..6c324bed 100644
--- a/docs-linter/.markdownlint.json
+++ b/docs-linter/.markdownlint.json
@@ -5,5 +5,6 @@
   "MD033": false, // Inline HTML. Essential for Docusaurus features (tabs, admonitions, specialized formatting).
   "MD034": false, // Bare URLs (e.g. https://example.com) without <brackets>. Common in quickstart guides.
   "MD009": false, // Trailing spaces. Flags every invisible space at the end of a line. Huge noise source.
-  "MD060": false  // Table column style. Flags tables that aren't perfectly ASCII-aligned in the raw text file. Purely visual.
+  "MD060": false, // Table column style. Flags tables that aren't perfectly ASCII-aligned in the raw text file. Purely visual.
+  "MD041": false  // First line heading. Fires on every Docusaurus category index page (MDX imports before any heading).
 }
\ No newline at end of file
diff --git a/docs-linter/.vale.ini b/docs-linter/.vale.ini
index 7edf5ced..4aa2b3c1 100644
--- a/docs-linter/.vale.ini
+++ b/docs-linter/.vale.ini
@@ -16,3 +16,4 @@ Microsoft.ComplexWords = NO
 Microsoft.Contractions = NO
 Microsoft.FirstPerson = NO
 Microsoft.HeadingPunctuation = NO
+Microsoft.Dashes = NO
diff --git a/packages/docusaurus-theme/css/legacy.css b/packages/docusaurus-theme/css/legacy.css
index a16fa86c..ccb6fc69 100644
--- a/packages/docusaurus-theme/css/legacy.css
+++ b/packages/docusaurus-theme/css/legacy.css
@@ -1989,6 +1989,16 @@ code {
     white-space: pre;
 }
 
+/* Inline code must wrap. The rule above forces white-space: pre on all <code>,
+   which is correct inside a scrollable <pre> code block but breaks inline code:
+   long commands or paths (e.g. `echo ${ZITI_CTRL_EDGE_ADVERTISED_ADDRESS}`) can't
+   scroll, so they push the page wider than the viewport and create horizontal
+   overflow on mobile. Re-enable wrapping for code that isn't inside a <pre>. */
+:not(pre) > code {
+    white-space: normal;
+    overflow-wrap: anywhere;
+}
+
 code p {
 }
 

From ae4bf417b3c502c7b902fda229b35f45e7cc24b7 Mon Sep 17 00:00:00 2001
From: Nico Alba <nico.alba@netfoundry.io>
Date: Thu, 11 Jun 2026 18:10:33 +0000
Subject: [PATCH 2/2] remove comment

---
 packages/docusaurus-theme/css/legacy.css | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/packages/docusaurus-theme/css/legacy.css b/packages/docusaurus-theme/css/legacy.css
index ccb6fc69..a404b367 100644
--- a/packages/docusaurus-theme/css/legacy.css
+++ b/packages/docusaurus-theme/css/legacy.css
@@ -1989,11 +1989,7 @@ code {
     white-space: pre;
 }
 
-/* Inline code must wrap. The rule above forces white-space: pre on all <code>,
-   which is correct inside a scrollable <pre> code block but breaks inline code:
-   long commands or paths (e.g. `echo ${ZITI_CTRL_EDGE_ADVERTISED_ADDRESS}`) can't
-   scroll, so they push the page wider than the viewport and create horizontal
-   overflow on mobile. Re-enable wrapping for code that isn't inside a <pre>. */
+/* Inline code must wrap; the rule above forces white-space: pre, which overflows the page on mobile. */
 :not(pre) > code {
     white-space: normal;
     overflow-wrap: anywhere;