From c9e56907f66d2340fdb7e6b3763fbf9efd1e9788 Mon Sep 17 00:00:00 2001
From: Vincent Baaij <vnbaaij@outlook.com>
Date: Fri, 13 Mar 2026 17:14:30 +0100
Subject: [PATCH] Update Dialog docs

---
 examples/Demo/Shared/Pages/Dialog/DialogPage.razor        | 3 +++
 src/Core/Components/Dialog/Parameters/DialogParameters.cs | 1 +
 2 files changed, 4 insertions(+)

diff --git a/examples/Demo/Shared/Pages/Dialog/DialogPage.razor b/examples/Demo/Shared/Pages/Dialog/DialogPage.razor
index 2353b515d1..7dcb39db4d 100644
--- a/examples/Demo/Shared/Pages/Dialog/DialogPage.razor
+++ b/examples/Demo/Shared/Pages/Dialog/DialogPage.razor
@@ -25,6 +25,9 @@
     <code>&lt;FluentDialog&gt;</code> wraps the <code>&lt;fluent-dialog&gt;</code> element, a web component implementation of a dialog leveraging
     the Fluent UI design system. <code>&lt;FluentDialog&gt;</code> acts as a shell for the dialog content, which can be specified in a number of ways.
 </p>
+<p>
+    Note: Dialogs are always displayed centered. The left/right positioning only works for Panels.
+</p>
 <h2>DialogService</h2>
 <p>
     The <code>DialogService</code> is a service which is used to show different types of dialogs. It is registered as a scoped service, so it can be injected into
diff --git a/src/Core/Components/Dialog/Parameters/DialogParameters.cs b/src/Core/Components/Dialog/Parameters/DialogParameters.cs
index d2573c4518..307c760988 100644
--- a/src/Core/Components/Dialog/Parameters/DialogParameters.cs
+++ b/src/Core/Components/Dialog/Parameters/DialogParameters.cs
@@ -17,6 +17,7 @@ public class DialogParameters : ComponentParameters, IDialogParameters
     /// left (full height), right (full height)
     /// or screen middle (using Width and Height properties).
     /// HorizontalAlignment.Stretch is not supported for this property.
+    /// NOTE: Left/Right only works for Panels, not Dialogs, which are always centered.
     /// </summary>
     public virtual HorizontalAlignment Alignment
     {