diff --git a/docs/elements/breakout.mdx b/docs/elements/breakout.mdx index 4d35f5f4..db3d62d2 100644 --- a/docs/elements/breakout.mdx +++ b/docs/elements/breakout.mdx @@ -6,11 +6,13 @@ description: >- ## Overview -A `` is similar to a [``](./group.mdx) but is meant for situations where you -want to guide the autorouter on where connections should exit the group. Inside -a breakout you can place [``](./breakoutpoint.mdx) elements to -define explicit exit locations, or let tscircuit generate breakout points for -connections that leave the breakout. +A `` is a transparent routing container similar to a +[``](./group.mdx). It does not create a subcircuit, selector scope, or +private net scope. Instead, its routing properties guide the autorouter on where +connections should exit the region. Inside a breakout you can place +[``](./breakoutpoint.mdx) elements to define explicit exit +locations, or let tscircuit generate breakout points for connections that leave +the breakout. import CircuitPreview from "@site/src/components/CircuitPreview" @@ -18,7 +20,7 @@ This 100-pin BGA keeps two 8-bit buses on contiguous outer columns and assigns each bus an explicit fanout direction. Eight center-region balls connect to GND and VCC pours on separate inner layers. -`. `busFanoutDirections` sends each named bus toward a specific side. +Because `` is transparent, its traces use the same GND and VCC nets +as the board-level copper pours. The pours do not need to be children of the +breakout, and no net exposure or separate `` is required. + `fanoutRoutingLayers={["top"]}` reserves the top layer for signal escape. The GND and VCC traces have only one component endpoint, so `fanoutPourNetMap` drops them to `inner1` and `inner2`. Those plane layers do not need to appear in `fanoutRoutingLayers`. When `fanoutPourNetMap` is omitted, tscircuit infers the plane destinations -from matching `` elements. An explicit map is useful when a net -has pours on multiple layers: +from matching `` elements on the enclosing board. An explicit map +is useful when a net has pours on multiple layers: ```tsx