update global anchors

ethanpalm · ethanpalm · commit 47331236f1e0 · 2025-08-14T13:42:21.000-07:00
diff --git a/navigation.mdx b/navigation.mdx
@@ -238,7 +238,9 @@ In the `navigation` object, `anchors` is an array where each entry is an object
 }
 ```
 
-Anchors that strictly contain external links can be achieved using the `global` keyword:
+Use a `global` object for anchors to external links that exist outside your navigation hierarchy. Anchors in a `global` object are particularly useful for linking to resources that are not part of your documentation like a blog or support portal, but should be readily accessible to your users.
+
+Anchors in a `global` object must have an `href` field and cannot direct to a relative path.
 
 ```json
 {

Original file line number	Diff line number	Diff line change
@@ -238,7 +238,9 @@ In the `navigation` object, `anchors` is an array where each entry is an object
`238`	`238`	`}`
`239`	`239`	```
`240`	`240`
`241`		-Anchors that strictly contain external links can be achieved using the `global` keyword:
	`241`	+Use a `global` object for anchors to external links that exist outside your navigation hierarchy. Anchors in a `global` object are particularly useful for linking to resources that are not part of your documentation like a blog or support portal, but should be readily accessible to your users.
	`242`	`+`
	`243`	+Anchors in a `global` object must have an `href` field and cannot direct to a relative path.
`242`	`244`
`243`	`245`	```json
`244`	`246`	`{`