From 25f94f8bfba35a6d9a050aa04659fbf828832103 Mon Sep 17 00:00:00 2001
From: Joe Vilches <joevilches@meta.com>
Date: Tue, 12 Mar 2024 11:31:46 -0700
Subject: [PATCH] Add align items self documentation (#1606)

Summary:
Pull Request resolved: https://github.com/facebook/yoga/pull/1606

tsia

Reviewed By: yungsters

Differential Revision: D54783193

fbshipit-source-id: 66d5d58eefec827024b2e029be7cbee637c5484e
---
 .../docs/examples/align-items-self.mdx        | 44 ++++++++++++++++++-
 1 file changed, 43 insertions(+), 1 deletion(-)

diff --git a/website-next/docs/examples/align-items-self.mdx b/website-next/docs/examples/align-items-self.mdx
index e66079d8..53e3b183 100644
--- a/website-next/docs/examples/align-items-self.mdx
+++ b/website-next/docs/examples/align-items-self.mdx
@@ -2,4 +2,46 @@
 sidebar_position: 2
 ---
 
-# Align Items and Align Self
+import Playground from '@site/src/components/Playground';
+
+# Align Items
+
+Align items describes how to align children along the cross axis of their container.
+Align items is very similar to [`justify content`](/docs/examples/justify-content) but instead of
+applying to the main axis, `align items` applies to the cross axis.
+
+**Stretch (default)**: Stretch children of a container to match the `height` of the container's cross axis.
+
+**Flex start**: Align children of a container to the start of the container's cross axis.
+
+**Flex end**: Align children of a container to the end of the container's cross axis.
+
+**Center**: Align children of a container in the center of the container's cross axis.
+
+**Baseline**: Align children of a container along a common baseline. Individual children can be set to be the reference baseline for their parents.
+
+# Align Self
+
+Align self has the same options and effect as `align items` but instead of
+affecting the children within a container, you can apply this property to
+a single child to change its alignment within its parent. `align self`
+overrides any option set by the parent with `align items`.
+
+<Playground code={`<Layout config={{useWebDefaults: false}}>
+  <Node
+    style={{
+      width: 250,
+      height: 250,
+      padding: 10,
+      alignItems: 'flex-start'
+    }}>
+    <Node
+      style={{
+        margin: 5,
+        height: 50,
+        width: 50,
+        alignSelf: 'center'
+      }}/>
+    <Node style={{margin: 5, height: 50, width: 50}} />
+  </Node>
+</Layout>`} />