From 122e4101e7348aa4f20485d50609c1f10c91b1bc Mon Sep 17 00:00:00 2001
From: Jesus <jesus.bamford@gmail.com>
Date: Fri, 17 Apr 2020 21:28:22 -0700
Subject: [PATCH 1/3] Added Documentation for Dialogs

Added documentation for every Dialog file except IDialogParameters/DialogParameters due to #2064
---
 .../Services/Dialogs/ButtonResult.cs          | 29 ++++++++-
 src/Wpf/Prism.Wpf/Services/Dialogs/Dialog.cs  | 39 +++++++++++-
 .../Services/Dialogs/DialogResult.cs          | 22 +++++++
 .../Services/Dialogs/DialogService.cs         | 60 ++++++++++++++++++-
 .../Services/Dialogs/DialogWindow.xaml.cs     |  8 ++-
 .../Services/Dialogs/IDialogAware.cs          | 11 ++--
 .../Services/Dialogs/IDialogResult.cs         |  6 +-
 .../Services/Dialogs/IDialogService.cs        | 31 +++++-----
 .../Services/Dialogs/IDialogWindow.cs         | 40 +++++++++++++
 .../Dialogs/IDialogWindowExtensions.cs        | 10 +++-
 10 files changed, 231 insertions(+), 25 deletions(-)

diff --git a/src/Wpf/Prism.Wpf/Services/Dialogs/ButtonResult.cs b/src/Wpf/Prism.Wpf/Services/Dialogs/ButtonResult.cs
index 102f61bda1..eeaa6eaa62 100644
--- a/src/Wpf/Prism.Wpf/Services/Dialogs/ButtonResult.cs
+++ b/src/Wpf/Prism.Wpf/Services/Dialogs/ButtonResult.cs
@@ -1,14 +1,41 @@
 namespace Prism.Services.Dialogs
 {
+    /// <summary>
+    /// The result of the dialog.
+    /// </summary>
     public enum ButtonResult
     {
+        /// <summary>
+        /// Abort.
+        /// </summary>
         Abort = 3,
+        /// <summary>
+        /// Cancel.
+        /// </summary>
         Cancel = 2,
+        /// <summary>
+        /// Ignore.
+        /// </summary>
         Ignore = 5,
+        /// <summary>
+        /// No.
+        /// </summary>
         No = 7,
+        /// <summary>
+        /// No result returned.
+        /// </summary>
         None = 0,
+        /// <summary>
+        /// OK.
+        /// </summary>
         OK = 1,
-        Retry = 4,        
+        /// <summary>
+        /// Retry.
+        /// </summary>
+        Retry = 4,
+        /// <summary>
+        /// Yes.
+        /// </summary>
         Yes = 6
     }
 }
diff --git a/src/Wpf/Prism.Wpf/Services/Dialogs/Dialog.cs b/src/Wpf/Prism.Wpf/Services/Dialogs/Dialog.cs
index 5b5c11667f..79ca52bb96 100644
--- a/src/Wpf/Prism.Wpf/Services/Dialogs/Dialog.cs
+++ b/src/Wpf/Prism.Wpf/Services/Dialogs/Dialog.cs
@@ -1,31 +1,66 @@
-using System;
-using System.Windows;
+using System.Windows;
 
 namespace Prism.Services.Dialogs
 {
+    /// <summary>
+    /// This class contains <see cref="IDialogWindow"/> attached properties.
+    /// </summary>
     public class Dialog
     {
+        /// <summary>
+        /// Identifies the WindowStyle attached property.
+        /// </summary>
+        /// <remarks>
+        /// This attached property is used to specify the style of a <see cref="IDialogWindow"/>.
+        /// </remarks>
         public static readonly DependencyProperty WindowStyleProperty =
             DependencyProperty.RegisterAttached("WindowStyle", typeof(Style), typeof(Dialog), new PropertyMetadata(null));
 
+        /// <summary>
+        /// Gets the value for the <see cref="WindowStyleProperty"/> attached property.
+        /// </summary>
+        /// <param name="obj">The target element.</param>
+        /// <returns>The <see cref="WindowStyleProperty"/> attached to the <paramref name="obj"/> element.</returns>
         public static Style GetWindowStyle(DependencyObject obj)
         {
             return (Style)obj.GetValue(WindowStyleProperty);
         }
 
+        /// <summary>
+        /// Sets the <see cref="WindowStyleProperty"/> attached property.
+        /// </summary>
+        /// <param name="obj">The target element.</param>
+        /// <param name="value">The Style to attach.</param>
         public static void SetWindowStyle(DependencyObject obj, Style value)
         {
             obj.SetValue(WindowStyleProperty, value);
         }
 
+        /// <summary>
+        /// Identifies the WindowStartupLocation attached property.
+        /// </summary>
+        /// <remarks>
+        /// This attached property is used to specify the startup location of a <see cref="IDialogWindow"/>.
+        /// The default startup location is <c>WindowStartupLocation.CenterOwner</c>.
+        /// </remarks>
         public static readonly DependencyProperty WindowStartupLocationProperty =
             DependencyProperty.RegisterAttached("WindowStartupLocation", typeof(WindowStartupLocation), typeof(Dialog), new UIPropertyMetadata(WindowStartupLocation.CenterOwner, OnWindowStartupLocationChanged));
 
+        /// <summary>
+        /// Gets the value for the <see cref="WindowStartupLocationProperty"/> attached property.
+        /// </summary>
+        /// <param name="obj">The target element.</param>
+        /// <returns>The <see cref="WindowStartupLocationProperty"/> attached to the <paramref name="obj"/> element.</returns>
         public static WindowStartupLocation GetWindowStartupLocation(DependencyObject obj)
         {
             return (WindowStartupLocation)obj.GetValue(WindowStartupLocationProperty);
         }
 
+        /// <summary>
+        /// Sets the <see cref="WindowStartupLocationProperty"/> attached property.
+        /// </summary>
+        /// <param name="obj">The target element.</param>
+        /// <param name="value">The WindowStartupLocation to attach.</param>
         public static void SetWindowStartupLocation(DependencyObject obj, WindowStartupLocation value)
         {
             obj.SetValue(WindowStartupLocationProperty, value);
diff --git a/src/Wpf/Prism.Wpf/Services/Dialogs/DialogResult.cs b/src/Wpf/Prism.Wpf/Services/Dialogs/DialogResult.cs
index 83c3aafdc8..967707f874 100644
--- a/src/Wpf/Prism.Wpf/Services/Dialogs/DialogResult.cs
+++ b/src/Wpf/Prism.Wpf/Services/Dialogs/DialogResult.cs
@@ -1,18 +1,40 @@
 namespace Prism.Services.Dialogs
 {
+    /// <summary>
+    /// An <see cref="IDialogResult"/> that contains <see cref="IDialogParameters"/> passed to the dialog
+    /// and the <see cref="ButtonResult"/> of the dialog.
+    /// </summary>
     public class DialogResult : IDialogResult
     {
+        /// <summary>
+        /// The parameters passed to the dialog.
+        /// </summary>
         public IDialogParameters Parameters { get; private set; } = new DialogParameters();
 
+        /// <summary>
+        /// The result of the dialog.
+        /// </summary>
         public ButtonResult Result { get; private set; } = ButtonResult.None;
 
+        /// <summary>
+        /// Initializes a new instance of the <see cref="DialogResult"/> class.
+        /// </summary>
         public DialogResult() { }
 
+        /// <summary>
+        /// Initializes a new instance of the <see cref="DialogResult"/> class.
+        /// </summary>
+        /// <param name="result">The result of the dialog.</param>
         public DialogResult(ButtonResult result)
         {
             Result = result;
         }
 
+        /// <summary>
+        /// Initializes a new instance of the <see cref="DialogResult"/> class.
+        /// </summary>
+        /// <param name="result">The result of the dialog.</param>
+        /// <param name="parameters">The parameters passed to the dialog.</param>
         public DialogResult(ButtonResult result, IDialogParameters parameters)
         {
             Result = result;
diff --git a/src/Wpf/Prism.Wpf/Services/Dialogs/DialogService.cs b/src/Wpf/Prism.Wpf/Services/Dialogs/DialogService.cs
index 60c2d0e1e2..7db4e0894f 100644
--- a/src/Wpf/Prism.Wpf/Services/Dialogs/DialogService.cs
+++ b/src/Wpf/Prism.Wpf/Services/Dialogs/DialogService.cs
@@ -7,30 +7,66 @@
 
 namespace Prism.Services.Dialogs
 {
+    /// <summary>
+    /// Implements <see cref="IDialogService"/> to show modal and non-modal dialogs.
+    /// </summary>
+    /// <remarks>
+    /// The dialog's ViewModel must implement IDialogAware.
+    /// </remarks>
     public class DialogService : IDialogService
     {
         private readonly IContainerExtension _containerExtension;
 
+        /// <summary>
+        /// Initializes a new instance of the <see cref="DialogService"/> class.
+        /// </summary>
+        /// <param name="containerExtension"></param>
         public DialogService(IContainerExtension containerExtension)
         {
             _containerExtension = containerExtension;
         }
 
+        /// <summary>
+        /// Shows a non-modal dialog.
+        /// </summary>
+        /// <param name="name">The name of the dialog to show.</param>
+        /// <param name="parameters">The parameters to pass to the dialog.</param>
+        /// <param name="callback">The action to perform when the dialog is closed.</param>
         public void Show(string name, IDialogParameters parameters, Action<IDialogResult> callback)
         {
             ShowDialogInternal(name, parameters, callback, false);
         }
 
+        /// <summary>
+        /// Shows a non-modal dialog.
+        /// </summary>
+        /// <param name="name">The name of the dialog to show.</param>
+        /// <param name="parameters">The parameters to pass to the dialog.</param>
+        /// <param name="callback">The action to perform when the dialog is closed.</param>
+        /// <param name="windowName">The name of the hosting window registered with the IContainerRegistry.</param>
         public void Show(string name, IDialogParameters parameters, Action<IDialogResult> callback, string windowName)
         {
             ShowDialogInternal(name, parameters, callback, false, windowName);
         }
 
+        /// <summary>
+        /// Shows a modal dialog.
+        /// </summary>
+        /// <param name="name">The name of the dialog to show.</param>
+        /// <param name="parameters">The parameters to pass to the dialog.</param>
+        /// <param name="callback">The action to perform when the dialog is closed.</param>
         public void ShowDialog(string name, IDialogParameters parameters, Action<IDialogResult> callback)
         {
             ShowDialogInternal(name, parameters, callback, true);
         }
 
+        /// <summary>
+        /// Shows a modal dialog.
+        /// </summary>
+        /// <param name="name">The name of the dialog to show.</param>
+        /// <param name="parameters">The parameters to pass to the dialog.</param>
+        /// <param name="callback">The action to perform when the dialog is closed.</param>
+        /// <param name="windowName">The name of the hosting window registered with the IContainerRegistry.</param>
         public void ShowDialog(string name, IDialogParameters parameters, Action<IDialogResult> callback, string windowName)
         {
             ShowDialogInternal(name, parameters, callback, true, windowName);
@@ -48,6 +84,11 @@ void ShowDialogInternal(string name, IDialogParameters parameters, Action<IDialo
                 dialogWindow.Show();
         }
 
+        /// <summary>
+        /// Create a new <see cref="IDialogWindow"/>
+        /// </summary>
+        /// <param name="name">The name of the hosting window registered with the IContainerRegistry.</param>
+        /// <returns>The created <see cref="IDialogWindow"/>.</returns>
         protected virtual IDialogWindow CreateDialogWindow(string name)
         {
             if (string.IsNullOrWhiteSpace(name))
@@ -56,6 +97,12 @@ protected virtual IDialogWindow CreateDialogWindow(string name)
                 return _containerExtension.Resolve<IDialogWindow>(name);
         }
 
+        /// <summary>
+        /// Configure <see cref="IDialogWindow"/> content.
+        /// </summary>
+        /// <param name="dialogName">The name of the dialog to show.</param>
+        /// <param name="window">The hosting window.</param>
+        /// <param name="parameters">The parameters to pass to the dialog.</param>
         protected virtual void ConfigureDialogWindowContent(string dialogName, IDialogWindow window, IDialogParameters parameters)
         {
             var content = _containerExtension.Resolve<object>(dialogName);
@@ -72,6 +119,11 @@ protected virtual void ConfigureDialogWindowContent(string dialogName, IDialogWi
             MvvmHelpers.ViewAndViewModelAction<IDialogAware>(viewModel, d => d.OnDialogOpened(parameters));
         }
 
+        /// <summary>
+        /// Configure <see cref="IDialogWindow"/> and <see cref="IDialogAware"/> events.
+        /// </summary>
+        /// <param name="dialogWindow">The hosting window.</param>
+        /// <param name="callback">The action to perform when the dialog is closed.</param>
         protected virtual void ConfigureDialogWindowEvents(IDialogWindow dialogWindow, Action<IDialogResult> callback)
         {
             Action<IDialogResult> requestCloseHandler = null;
@@ -117,6 +169,12 @@ protected virtual void ConfigureDialogWindowEvents(IDialogWindow dialogWindow, A
             dialogWindow.Closed += closedHandler;
         }
 
+        /// <summary>
+        /// Configure <see cref="IDialogWindow"/> properties.
+        /// </summary>
+        /// <param name="window">The hosting window.</param>
+        /// <param name="dialogContent">The dialog to show.</param>
+        /// <param name="viewModel">The dialog's ViewModel.</param>
         protected virtual void ConfigureDialogWindowProperties(IDialogWindow window, FrameworkElement dialogContent, IDialogAware viewModel)
         {
             var windowStyle = Dialog.GetWindowStyle(dialogContent);
@@ -124,7 +182,7 @@ protected virtual void ConfigureDialogWindowProperties(IDialogWindow window, Fra
                 window.Style = windowStyle;
 
             window.Content = dialogContent;
-            window.DataContext = viewModel; //we want the host window and the dialog to share the same data contex
+            window.DataContext = viewModel; //we want the host window and the dialog to share the same data context
 
             if (window.Owner == null)
                 window.Owner = Application.Current?.Windows.OfType<Window>().FirstOrDefault(x => x.IsActive);
diff --git a/src/Wpf/Prism.Wpf/Services/Dialogs/DialogWindow.xaml.cs b/src/Wpf/Prism.Wpf/Services/Dialogs/DialogWindow.xaml.cs
index c1ce278ea4..e336555ea4 100644
--- a/src/Wpf/Prism.Wpf/Services/Dialogs/DialogWindow.xaml.cs
+++ b/src/Wpf/Prism.Wpf/Services/Dialogs/DialogWindow.xaml.cs
@@ -3,12 +3,18 @@
 namespace Prism.Services.Dialogs
 {
     /// <summary>
-    /// Interaction logic for DialogWindow.xaml
+    /// Prism's default dialog host.
     /// </summary>
     public partial class DialogWindow : Window, IDialogWindow
     {
+        /// <summary>
+        /// The <see cref="IDialogResult"/> of the dialog.
+        /// </summary>
         public IDialogResult Result { get; set; }
 
+        /// <summary>
+        /// Initializes a new instance of the <see cref="DialogWindow"/> class.
+        /// </summary>
         public DialogWindow()
         {
             InitializeComponent();
diff --git a/src/Wpf/Prism.Wpf/Services/Dialogs/IDialogAware.cs b/src/Wpf/Prism.Wpf/Services/Dialogs/IDialogAware.cs
index 13ec74a99d..7117f5776d 100644
--- a/src/Wpf/Prism.Wpf/Services/Dialogs/IDialogAware.cs
+++ b/src/Wpf/Prism.Wpf/Services/Dialogs/IDialogAware.cs
@@ -2,12 +2,15 @@
 
 namespace Prism.Services.Dialogs
 {
+    /// <summary>
+    /// Interface that provides dialog functions and events to ViewModels.
+    /// </summary>
     public interface IDialogAware
     {
         /// <summary>
         /// Determines if the dialog can be closed.
         /// </summary>
-        /// <returns>True: close the dialog; False: the dialog will not close</returns>
+        /// <returns>If <c>true</c> the dialog can be closed. If <c>false</c> the dialog will not close.</returns>
         bool CanCloseDialog();
 
         /// <summary>
@@ -18,16 +21,16 @@ public interface IDialogAware
         /// <summary>
         /// Called when the dialog is opened.
         /// </summary>
-        /// <param name="parameters">The parameters passed to the dialog</param>
+        /// <param name="parameters">The parameters passed to the dialog.</param>
         void OnDialogOpened(IDialogParameters parameters);
 
         /// <summary>
-        /// The title of the dialog that will show in the Window title bar.
+        /// The title of the dialog that will show in the window title bar.
         /// </summary>
         string Title { get; }
 
         /// <summary>
-        /// Instructs the IDialogWindow to close the dialog.
+        /// Instructs the <see cref="IDialogWindow"/> to close the dialog.
         /// </summary>
         event Action<IDialogResult> RequestClose;
     }
diff --git a/src/Wpf/Prism.Wpf/Services/Dialogs/IDialogResult.cs b/src/Wpf/Prism.Wpf/Services/Dialogs/IDialogResult.cs
index cf6bd07fdc..28656a2dc1 100644
--- a/src/Wpf/Prism.Wpf/Services/Dialogs/IDialogResult.cs
+++ b/src/Wpf/Prism.Wpf/Services/Dialogs/IDialogResult.cs
@@ -1,9 +1,13 @@
 namespace Prism.Services.Dialogs
 {
+    /// <summary>
+    /// Contains <see cref="IDialogParameters"/> passed to the dialog
+    /// and the <see cref="ButtonResult"/> of the dialog.
+    /// </summary>
     public interface IDialogResult
     {
         /// <summary>
-        /// The parameters from the dialog
+        /// The parameters passed to the dialog.
         /// </summary>
         IDialogParameters Parameters { get; }
 
diff --git a/src/Wpf/Prism.Wpf/Services/Dialogs/IDialogService.cs b/src/Wpf/Prism.Wpf/Services/Dialogs/IDialogService.cs
index ec53bfa375..390a140a51 100644
--- a/src/Wpf/Prism.Wpf/Services/Dialogs/IDialogService.cs
+++ b/src/Wpf/Prism.Wpf/Services/Dialogs/IDialogService.cs
@@ -2,41 +2,44 @@
 
 namespace Prism.Services.Dialogs
 {
+    /// <summary>
+    /// Interface to show modal and non-modal dialogs.
+    /// </summary>
     public interface IDialogService
     {
         /// <summary>
-        /// Shows a non-modal dialog
+        /// Shows a non-modal dialog.
         /// </summary>
-        /// <param name="name">The name of the dialog to show</param>
-        /// <param name="parameters">The parameters to pass to the dialog</param>
+        /// <param name="name">The name of the dialog to show.</param>
+        /// <param name="parameters">The parameters to pass to the dialog.</param>
         /// <param name="callback">The action to perform when the dialog is closed.</param>
         void Show(string name, IDialogParameters parameters, Action<IDialogResult> callback);
 
         /// <summary>
-        /// Shows a non-modal dialog
+        /// Shows a non-modal dialog.
         /// </summary>
-        /// <param name="name">The name of the dialog to show</param>
-        /// <param name="parameters">The parameters to pass to the dialog</param>
+        /// <param name="name">The name of the dialog to show.</param>
+        /// <param name="parameters">The parameters to pass to the dialog.</param>
         /// <param name="callback">The action to perform when the dialog is closed.</param>
-        /// <param name="windowName">The name of the hosting window registered with the IContainerRegistry</param>
+        /// <param name="windowName">The name of the hosting window registered with the IContainerRegistry.</param>
         void Show(string name, IDialogParameters parameters, Action<IDialogResult> callback, string windowName);
 
         /// <summary>
-        /// Shows a modal dialog
+        /// Shows a modal dialog.
         /// </summary>
-        /// <param name="name">The name of the dialog to show</param>
-        /// <param name="parameters">The parameters to pass to the dialog</param>
+        /// <param name="name">The name of the dialog to show.</param>
+        /// <param name="parameters">The parameters to pass to the dialog.</param>
         /// <param name="callback">The action to perform when the dialog is closed.</param>
         void ShowDialog(string name, IDialogParameters parameters, Action<IDialogResult> callback);
 
 
         /// <summary>
-        /// Shows a modal dialog
+        /// Shows a modal dialog.
         /// </summary>
-        /// <param name="name">The name of the dialog to show</param>
-        /// <param name="parameters">The parameters to pass to the dialog</param>
+        /// <param name="name">The name of the dialog to show.</param>
+        /// <param name="parameters">The parameters to pass to the dialog.</param>
         /// <param name="callback">The action to perform when the dialog is closed.</param>
-        /// <param name="windowName">The name of the hosting window registered with the IContainerRegistry</param>
+        /// <param name="windowName">The name of the hosting window registered with the IContainerRegistry.</param>
         void ShowDialog(string name, IDialogParameters parameters, Action<IDialogResult> callback, string windowName);
     }
 }
diff --git a/src/Wpf/Prism.Wpf/Services/Dialogs/IDialogWindow.cs b/src/Wpf/Prism.Wpf/Services/Dialogs/IDialogWindow.cs
index d7140118af..10ebc7708a 100644
--- a/src/Wpf/Prism.Wpf/Services/Dialogs/IDialogWindow.cs
+++ b/src/Wpf/Prism.Wpf/Services/Dialogs/IDialogWindow.cs
@@ -4,28 +4,68 @@
 
 namespace Prism.Services.Dialogs
 {
+    /// <summary>
+    /// Interface for a dialog hosting window
+    /// </summary>
     public interface IDialogWindow
     {
+        /// <summary>
+        /// Dialog content.
+        /// </summary>
         object Content { get; set; }
 
+        /// <summary>
+        /// Close the window.
+        /// </summary>
         void Close();
 
+        /// <summary>
+        /// The window's owner.
+        /// </summary>
         Window Owner { get; set; }
 
+        /// <summary>
+        /// Show a non-modal dialog.
+        /// </summary>
         void Show();
 
+        /// <summary>
+        /// Show a modal dialog.
+        /// </summary>
+        /// <returns></returns>
         bool? ShowDialog();
 
+        /// <summary>
+        /// The data context of the window.
+        /// </summary>
+        /// <remarks>
+        /// The data context must implement <see cref="IDialogAware"/>.
+        /// </remarks>
         object DataContext { get; set; }
 
+        /// <summary>
+        /// Called when the window is loaded.
+        /// </summary>
         event RoutedEventHandler Loaded;
 
+        /// <summary>
+        /// Called when the window is closed.
+        /// </summary>
         event EventHandler Closed;
 
+        /// <summary>
+        /// Called when the window is closing.
+        /// </summary>
         event CancelEventHandler Closing;
 
+        /// <summary>
+        /// The result of the dialog.
+        /// </summary>
         IDialogResult Result { get; set; }
 
+        /// <summary>
+        /// The window style.
+        /// </summary>
         Style Style { get; set; }
     }
 }
diff --git a/src/Wpf/Prism.Wpf/Services/Dialogs/IDialogWindowExtensions.cs b/src/Wpf/Prism.Wpf/Services/Dialogs/IDialogWindowExtensions.cs
index d52d36e5d0..45aa5c7adb 100644
--- a/src/Wpf/Prism.Wpf/Services/Dialogs/IDialogWindowExtensions.cs
+++ b/src/Wpf/Prism.Wpf/Services/Dialogs/IDialogWindowExtensions.cs
@@ -1,10 +1,18 @@
 namespace Prism.Services.Dialogs
 {
+    /// <summary>
+    /// <see cref="IDialogWindow"/> extensions.
+    /// </summary>
     internal static class IDialogWindowExtensions
     {
+        /// <summary>
+        /// Get the <see cref="IDialogAware"/> ViewModel from a <see cref="IDialogWindow"/>.
+        /// </summary>
+        /// <param name="dialogWindow"><see cref="IDialogWindow"/> to get ViewModel from.</param>
+        /// <returns>ViewModel as a <see cref="IDialogAware"/>.</returns>
         internal static IDialogAware GetDialogViewModel(this IDialogWindow dialogWindow)
         {
             return (IDialogAware)dialogWindow.DataContext;
         }
     }
-}
+}
\ No newline at end of file

From 09c154f35c5e7623d1bee73aa83bf3c2c53c5c7e Mon Sep 17 00:00:00 2001
From: Jesus <jesus.bamford@gmail.com>
Date: Fri, 17 Apr 2020 21:30:21 -0700
Subject: [PATCH 2/3] Forgot a single period

---
 src/Wpf/Prism.Wpf/Services/Dialogs/DialogService.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Wpf/Prism.Wpf/Services/Dialogs/DialogService.cs b/src/Wpf/Prism.Wpf/Services/Dialogs/DialogService.cs
index 7db4e0894f..6ca3512880 100644
--- a/src/Wpf/Prism.Wpf/Services/Dialogs/DialogService.cs
+++ b/src/Wpf/Prism.Wpf/Services/Dialogs/DialogService.cs
@@ -85,7 +85,7 @@ void ShowDialogInternal(string name, IDialogParameters parameters, Action<IDialo
         }
 
         /// <summary>
-        /// Create a new <see cref="IDialogWindow"/>
+        /// Create a new <see cref="IDialogWindow"/>.
         /// </summary>
         /// <param name="name">The name of the hosting window registered with the IContainerRegistry.</param>
         /// <returns>The created <see cref="IDialogWindow"/>.</returns>

From 646cf1c87765e7a67f39ca75b6c805a4fa900407 Mon Sep 17 00:00:00 2001
From: Jesus <jesus.bamford@gmail.com>
Date: Sat, 18 Apr 2020 19:58:43 -0700
Subject: [PATCH 3/3] Reverted IDialogResult and DialogResult comments

---
 src/Wpf/Prism.Wpf/Services/Dialogs/DialogResult.cs  | 6 +++---
 src/Wpf/Prism.Wpf/Services/Dialogs/IDialogResult.cs | 4 ++--
 src/Wpf/Prism.Wpf/Services/Dialogs/IDialogWindow.cs | 2 +-
 3 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/src/Wpf/Prism.Wpf/Services/Dialogs/DialogResult.cs b/src/Wpf/Prism.Wpf/Services/Dialogs/DialogResult.cs
index 967707f874..f0c9a8c5ef 100644
--- a/src/Wpf/Prism.Wpf/Services/Dialogs/DialogResult.cs
+++ b/src/Wpf/Prism.Wpf/Services/Dialogs/DialogResult.cs
@@ -1,13 +1,13 @@
 namespace Prism.Services.Dialogs
 {
     /// <summary>
-    /// An <see cref="IDialogResult"/> that contains <see cref="IDialogParameters"/> passed to the dialog
+    /// An <see cref="IDialogResult"/> that contains <see cref="IDialogParameters"/> from the dialog
     /// and the <see cref="ButtonResult"/> of the dialog.
     /// </summary>
     public class DialogResult : IDialogResult
     {
         /// <summary>
-        /// The parameters passed to the dialog.
+        /// The parameters from the dialog.
         /// </summary>
         public IDialogParameters Parameters { get; private set; } = new DialogParameters();
 
@@ -34,7 +34,7 @@ public DialogResult(ButtonResult result)
         /// Initializes a new instance of the <see cref="DialogResult"/> class.
         /// </summary>
         /// <param name="result">The result of the dialog.</param>
-        /// <param name="parameters">The parameters passed to the dialog.</param>
+        /// <param name="parameters">The parameters from the dialog.</param>
         public DialogResult(ButtonResult result, IDialogParameters parameters)
         {
             Result = result;
diff --git a/src/Wpf/Prism.Wpf/Services/Dialogs/IDialogResult.cs b/src/Wpf/Prism.Wpf/Services/Dialogs/IDialogResult.cs
index 28656a2dc1..0e4228a6be 100644
--- a/src/Wpf/Prism.Wpf/Services/Dialogs/IDialogResult.cs
+++ b/src/Wpf/Prism.Wpf/Services/Dialogs/IDialogResult.cs
@@ -1,13 +1,13 @@
 namespace Prism.Services.Dialogs
 {
     /// <summary>
-    /// Contains <see cref="IDialogParameters"/> passed to the dialog
+    /// Contains <see cref="IDialogParameters"/> from the dialog
     /// and the <see cref="ButtonResult"/> of the dialog.
     /// </summary>
     public interface IDialogResult
     {
         /// <summary>
-        /// The parameters passed to the dialog.
+        /// The parameters from the dialog.
         /// </summary>
         IDialogParameters Parameters { get; }
 
diff --git a/src/Wpf/Prism.Wpf/Services/Dialogs/IDialogWindow.cs b/src/Wpf/Prism.Wpf/Services/Dialogs/IDialogWindow.cs
index 10ebc7708a..69905d6a9d 100644
--- a/src/Wpf/Prism.Wpf/Services/Dialogs/IDialogWindow.cs
+++ b/src/Wpf/Prism.Wpf/Services/Dialogs/IDialogWindow.cs
@@ -5,7 +5,7 @@
 namespace Prism.Services.Dialogs
 {
     /// <summary>
-    /// Interface for a dialog hosting window
+    /// Interface for a dialog hosting window.
     /// </summary>
     public interface IDialogWindow
     {