Finish the layout docs

1 files changed, 15 insertions, 1 deletions

diff --git a/library/src/layout/stack.rs b/library/src/layout/stack.rs
index c423b1a3..39e040b3 100644
--- a/library/src/layout/stack.rs
+++ b/library/src/layout/stack.rs
@@ -4,7 +4,21 @@ use super::{AlignNode, Spacing};
 use crate::prelude::*;
 
 /// # Stack
-/// Arrange content and spacing along an axis.
+/// Arrange content and spacing horizontally or vertically.
+///
+/// The stack places a list of items along an axis, with optional spacing
+/// between each item.
+///
+/// ## Example
+/// ```
+/// #stack(
+///   dir: ttb,
+///
+///   rect(width: 40pt),
+///   rect(width: 120pt),
+///   rect(width: 90pt),
+/// )
+/// ```
 ///
 /// ## Parameters
 /// - items: StackChild (positional, variadic)