From 7dfef863d012e841fa53a77a7253937bb4c87408 Mon Sep 17 00:00:00 2001
From: eriklimakc <erik.lima@knowcode.app>
Date: Mon, 15 Jul 2024 20:04:00 +0100
Subject: [PATCH] docs: Add TextBox Placeholder and Header breaking change
 section

---
 doc/material-migration.md | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/doc/material-migration.md b/doc/material-migration.md
index 6d1ebf193..af80706ba 100644
--- a/doc/material-migration.md
+++ b/doc/material-migration.md
@@ -8,6 +8,33 @@ uid: Uno.Themes.Material.Migration
 
 The Uno Material v5 packages introduce a new dependency on the [Uno Themes](https://www.nuget.org/packages/Uno.Themes.WinUI) package. Uno Themes is the base library for all design system implementations going forward. As a result, the following changes have been made:
 
+### Upgrading to Uno Themes 5.1
+
+#### TextBox `PlaceholderText` and `Header`
+
+Previously, the `PlaceholderText` attribute acted as a header, displaying in a normal state and animating upwards when text was entered. Now, both `PlaceholderText` and `Header` are supported and the behavior changed.
+
+##### New Behavior
+
+- **PlaceholderText**: Displays inside the TextBox when it's empty. Disappears when text is entered.
+- **Header**: Acts as a label. Animates upwards when the TextBox is clicked.
+
+##### Example
+
+**Old Usage:**
+
+```xml
+<TextBox PlaceholderText="Enter your name" />
+```
+
+**New Usage:**
+
+```xml
+<TextBox PlaceholderText="Enter your name" Header="Name" />
+```
+
+Update your TextBox elements to use `Header` for labels and `PlaceholderText` for placeholders.
+
 ### Converters
 
 All Converters were moved to the base `Uno.Themes` library, and the new `namespace` is `Uno.Themes`.