diff --git a/Terminal.Gui/View/ViewText.cs b/Terminal.Gui/View/ViewText.cs
index d6490020f..306a67cc3 100644
--- a/Terminal.Gui/View/ViewText.cs
+++ b/Terminal.Gui/View/ViewText.cs
@@ -34,7 +34,7 @@ public partial class View
///
///
/// The text will be drawn starting at the view origin (0, 0) and will be formatted according
- /// to and .
+ /// to and .
///
///
/// The text will word-wrap to additional lines if it does not fit horizontally. If 's height
@@ -87,7 +87,7 @@ public partial class View
/// or are using , the will be adjusted to fit the text.
///
/// The text justification.
- public virtual Justification Justification
+ public virtual Justification TextJustification
{
get => TextFormatter.Justification;
set
@@ -130,7 +130,7 @@ public partial class View
/// or are using , the will be adjusted to fit the text.
///
/// The vertical text justification.
- public virtual Justification VerticalJustification
+ public virtual Justification VerticalTextJustification
{
get => TextFormatter.VerticalJustification;
set
diff --git a/docfx/docs/migratingfromv1.md b/docfx/docs/migratingfromv1.md
index add576bbb..e8ddacc1a 100644
--- a/docfx/docs/migratingfromv1.md
+++ b/docfx/docs/migratingfromv1.md
@@ -231,4 +231,16 @@ Replace references to to nested types with the new standalone version
```diff
- var myTab = new TabView.Tab();
+ var myTab = new Tab();
-```
\ No newline at end of file
+```
+
+## View and Text Alignment is now Justification
+
+In v1, both `TextAlignment` and `VerticalTextAlignment` enums were used to align text in views. In v2, these enums have been replaced with the `Justification` enum. The `View.TextJustification` property controls horizontal text alignment, and the `View.VerticalTextAlignment` property controls vertical text alignment.
+
+v2 now supports `Pos.Justify` which enables views to be justified within their superview.
+
+### How to Fix
+
+* Replace `TextAlignment` with `Justification`
+* Replace `VerticalTextAlignment` with `Justification`. `Middle` is now `Center`.
+* Update any code that used `View.TextAlignment` or `View.VerticalTextAlignment` to justify text in views.