From 85f513d55f99f92f062f9df0befc910265ac51d1 Mon Sep 17 00:00:00 2001
From: Bradley Axen <baxen@squareup.com>
Date: Sun, 5 Apr 2026 16:39:40 -0700
Subject: [PATCH] fix: resolve MDX compilation error in using-goosehints.md
 (#8332)

Signed-off-by: Bradley Axen <baxen@squareup.com>
---
 .../docs/guides/context-engineering/using-goosehints.md   | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/documentation/docs/guides/context-engineering/using-goosehints.md b/documentation/docs/guides/context-engineering/using-goosehints.md
index aeb08d5c43..cf53fb9b1d 100644
--- a/documentation/docs/guides/context-engineering/using-goosehints.md
+++ b/documentation/docs/guides/context-engineering/using-goosehints.md
@@ -151,8 +151,6 @@ If you start goose in `my-project/`, the root-level hints are loaded immediately
         Use conventional commits for all changes.
         ```
    </details>
-
-After nested hints are loaded for a directory, they remain active for the rest of the session. If you update a hint file and want goose to pick up the new content reliably, restart the session.
 2. <details>
      <summary>`frontend/.goosehints`</summary>
         ```
@@ -179,7 +177,7 @@ After nested hints are loaded for a directory, they remain active for the rest o
 
         Always confirm UI changes with design team before implementation.
         ```
-   </details> 
+   </details>
 3. <details>
      <summary>`frontend/components/.goosehints` (current directory)</summary>
         ```
@@ -195,6 +193,10 @@ After nested hints are loaded for a directory, they remain active for the rest o
         ```
    </details>
 
+:::note
+After nested hints are loaded for a directory, they remain active for the rest of the session. If you update a hint file and want goose to pick up the new content reliably, restart the session.
+:::
+
 ## Common Use Cases
 Here are some ways people have used hints to provide additional context to goose: