diff --git a/content/docs/guide/slotted-pages.md b/content/docs/guide/slotted-pages.md
index d5dbef30c..a9f3faeae 100644
--- a/content/docs/guide/slotted-pages.md
+++ b/content/docs/guide/slotted-pages.md
@@ -66,8 +66,13 @@ export const AccountDetailPage: Page = {
 ```
 
 Result: the account record page renders with your custom header, and
-the synthesizer fills in the highlights, tabs (Details / Related /
-History), and discussion regions as if you'd authored nothing else.
+the synthesizer fills in the highlights, tabs, and discussion regions as
+if you'd authored nothing else. The default tab strip is **Details** → one
+tab per related list flagged `relatedList: 'primary'` on its relationship → a
+shared **Related** tab for the rest → **History**; so promoting a child table to
+its own tab is a one-word change on the relationship, not a page-authoring task.
+`relatedLayout: 'tabs' | 'stack'` remains an app-level override (force
+all-own-tabs / all-stacked).
 
 ## Composing default + custom