From f9c1989d0102866b6737a5924991490683d5f08b Mon Sep 17 00:00:00 2001
From: Mike Norman <mknorman@gmail.com>
Date: Thu, 1 Jun 2017 12:21:50 -0500
Subject: Updated example code in API docs for first few types in core. (#955)

* Updated example code in API docs for first few types in core, alphabetically.
---
 .../Xamarin.Forms/AbsoluteLayout.xml               | 210 +++++++++------------
 .../Xamarin.Forms/AppLinkEntry.xml                 |   6 +-
 .../Xamarin.Forms/Application.xml                  |   4 +-
 docs/Xamarin.Forms.Core/Xamarin.Forms/Behavior.xml |   1 +
 .../Xamarin.Forms/Behavior`1.xml                   |   1 +
 .../Xamarin.Forms/BindableProperty.xml             |  64 +++----
 6 files changed, 125 insertions(+), 161 deletions(-)

(limited to 'docs/Xamarin.Forms.Core')

diff --git a/docs/Xamarin.Forms.Core/Xamarin.Forms/AbsoluteLayout.xml b/docs/Xamarin.Forms.Core/Xamarin.Forms/AbsoluteLayout.xml
index cbe63a58..28e09a8e 100644
--- a/docs/Xamarin.Forms.Core/Xamarin.Forms/AbsoluteLayout.xml
+++ b/docs/Xamarin.Forms.Core/Xamarin.Forms/AbsoluteLayout.xml
@@ -25,153 +25,113 @@
       <example>
         <para>The following example shows how to use an <see cref="T:Xamarin.Forms.AbsoluteLayout" /> with proportional position arguments.</para>
         <code lang="C#"><![CDATA[
-using System;
-using Xamarin.Forms;
 
-namespace AbsoluteLayoutDemo
-{
-    class AbsoluteLayoutDemoPage : ContentPage
+    Label header = new Label
     {
-        //Label topLeftText;
-        Label topLeftLabel, centerLabel, bottomRightLabel;
-
-        public AbsoluteLayoutDemoPage ()
-        {
-            Label header = new Label {
-                Text = "AbsoluteLayout Demo",
-                Font = Font.SystemFontOfSize (NamedSize.Large),
-                HorizontalOptions = LayoutOptions.Center
-            };
-
-            AbsoluteLayout simpleLayout = new AbsoluteLayout {
-                BackgroundColor = Color.Blue.WithLuminosity (0.9),
-                VerticalOptions = LayoutOptions.FillAndExpand
-            };
-
-            topLeftLabel = new Label {
-                Text = "Top Left",
-                TextColor = Color.Black
-            };
-
-            centerLabel = new Label {
-                Text = "Centered",
-                TextColor = Color.Black
-            };
-
-            bottomRightLabel = new Label { 
-                Text = "Bottom Right",
-                TextColor = Color.Black
-            };
+        Text = "AbsoluteLayout Demo",
+        FontSize = Device.GetNamedSize(NamedSize.Large, typeof(Label)),
+        HorizontalOptions = LayoutOptions.Center
+    };
 
+    AbsoluteLayout simpleLayout = new AbsoluteLayout
+    {
+        BackgroundColor = Color.Blue.WithLuminosity(0.9),
+        VerticalOptions = LayoutOptions.FillAndExpand
+    };
 
-            // PositionProportional flag maps the range (0.0, 1.0) to
-            // the range "flush [left|top]" to "flush [right|bottom]"
-            AbsoluteLayout.SetLayoutFlags (bottomRightLabel,
-                AbsoluteLayoutFlags.PositionProportional);
+    topLeftLabel = new Label
+    {
+        Text = "Top Left",
+        TextColor = Color.Black
+    };
 
-            AbsoluteLayout.SetLayoutBounds (topLeftLabel,
-                new Rectangle (0f,
-                    0f, AbsoluteLayout.AutoSize, AbsoluteLayout.AutoSize));
+    centerLabel = new Label
+    {
+        Text = "Centered",
+        TextColor = Color.Black
+    };
 
-            AbsoluteLayout.SetLayoutFlags (centerLabel,
-                AbsoluteLayoutFlags.PositionProportional);
+    bottomRightLabel = new Label
+    {
+        Text = "Bottom Right",
+        TextColor = Color.Black
+    };
 
-            AbsoluteLayout.SetLayoutBounds (centerLabel,
-                new Rectangle (0.5,
-                    0.5, AbsoluteLayout.AutoSize, AbsoluteLayout.AutoSize));
+    // PositionProportional flag maps the range (0.0, 1.0) to
+    // the range "flush [left|top]" to "flush [right|bottom]"
+    AbsoluteLayout.SetLayoutFlags(bottomRightLabel,
+        AbsoluteLayoutFlags.PositionProportional);
 
-            AbsoluteLayout.SetLayoutFlags (bottomRightLabel,
-                AbsoluteLayoutFlags.PositionProportional);
+    AbsoluteLayout.SetLayoutBounds(topLeftLabel,
+        new Rectangle(0f,
+            0f, AbsoluteLayout.AutoSize, AbsoluteLayout.AutoSize));
 
-            AbsoluteLayout.SetLayoutBounds (bottomRightLabel,
-                new Rectangle (1f,
-                    1f, AbsoluteLayout.AutoSize, AbsoluteLayout.AutoSize));
+    AbsoluteLayout.SetLayoutFlags(centerLabel,
+        AbsoluteLayoutFlags.PositionProportional);
 
-            simpleLayout.Children.Add (topLeftLabel);
-            simpleLayout.Children.Add (centerLabel);
-            simpleLayout.Children.Add (bottomRightLabel);
+    AbsoluteLayout.SetLayoutBounds(centerLabel,
+        new Rectangle(0.5,
+            0.5, AbsoluteLayout.AutoSize, AbsoluteLayout.AutoSize));
 
-            // Accomodate iPhone status bar.
-            this.Padding = 
-                new Thickness (10, Device.OnPlatform (20, 0, 0), 10, 5);
+    AbsoluteLayout.SetLayoutFlags(bottomRightLabel,
+        AbsoluteLayoutFlags.PositionProportional);
 
-            // Build the page.
-            this.Content = new StackLayout {
-                Children = {
-                    header,
-                    simpleLayout
-                }
-            };
+    AbsoluteLayout.SetLayoutBounds(bottomRightLabel,
+        new Rectangle(1f,
+            1f, AbsoluteLayout.AutoSize, AbsoluteLayout.AutoSize));
 
-        }
-    }
-}
-]]></code>
+    simpleLayout.Children.Add(topLeftLabel);
+    simpleLayout.Children.Add(centerLabel);
+    simpleLayout.Children.Add(bottomRightLabel);
+    ]]></code>
         <para>The code sample below shows how to place two labels by specifying device-dependent units.</para>
         <code lang="C#"><![CDATA[
-using System;
-using Xamarin.Forms;
 
-namespace AbsoluteLayoutDemo
-{
-    public class AbsoluteLayoutDeviceUnits : ContentPage
+    AbsoluteLayout simpleLayout = new AbsoluteLayout
     {
-        Label topLeftText, middleText;
-
-        public AbsoluteLayoutDeviceUnits ()
-        {
-            AbsoluteLayout simpleLayout = new AbsoluteLayout {
-
-                BackgroundColor = Color.Blue.WithLuminosity (0.9),
-                VerticalOptions = LayoutOptions.FillAndExpand
-            };
 
-            Label header = new Label {
-                Text = "Device Units Demo",
-                TextColor = Color.Black,
-                Font = Font.SystemFontOfSize (NamedSize.Large)
-            };
+        BackgroundColor = Color.Blue.WithLuminosity(0.9),
+        VerticalOptions = LayoutOptions.FillAndExpand
+    };
 
-            topLeftText = new Label {
-                Text = "Left",
-                TextColor = Color.Black
-            };
+    Label header = new Label
+    {
+        Text = "Device Units Demo",
+        TextColor = Color.Black,
+        FontSize = Device.GetNamedSize(NamedSize.Large, typeof(Label))
+    };
 
-            AbsoluteLayout.SetLayoutFlags (topLeftText,
-                AbsoluteLayoutFlags.None);
+    topLeftText = new Label
+    {
+        Text = "Left",
+        TextColor = Color.Black
+    };
 
-            AbsoluteLayout.SetLayoutBounds (topLeftText,
-                new Rectangle (0f, 0f,  100f, 50f));
+    AbsoluteLayout.SetLayoutFlags(topLeftText,
+        AbsoluteLayoutFlags.None);
 
-            middleText = new Label {
-                Text = "Device-dependent location",
-                TextColor = Color.Black
-            };
+    AbsoluteLayout.SetLayoutBounds(topLeftText,
+        new Rectangle(0f, 0f, 100f, 50f));
 
-            AbsoluteLayout.SetLayoutFlags (middleText,
-                AbsoluteLayoutFlags.None);
+    middleText = new Label
+    {
+        Text = "Device-dependent location",
+        TextColor = Color.Black
+    };
 
-            AbsoluteLayout.SetLayoutBounds (middleText,
-                new Rectangle (100f, 200f, 200f, 50f));
+    AbsoluteLayout.SetLayoutFlags(middleText,
+        AbsoluteLayoutFlags.None);
 
-            simpleLayout.Children.Add (topLeftText);
-            simpleLayout.Children.Add (middleText);
+    AbsoluteLayout.SetLayoutBounds(middleText,
+        new Rectangle(100f, 200f, 200f, 50f));
 
-            // Accomodate iPhone status bar.
-            this.Padding = new Thickness (10, Device.OnPlatform (20, 0, 0), 10, 5);
+    simpleLayout.Children.Add(topLeftText);
+    simpleLayout.Children.Add(middleText);
 
-            this.Content = new StackLayout {
-                Children = {
-                    header,
-                    simpleLayout
-                }
-            };
-        }
-    }
-}]]></code>
+    }]]></code>
       </example>
       <para>The following image shows the AbsoluteLayout demo from the <format type="text/html"><a href="http://developer.xamarin.com/samples/tag/Xamarin.Forms/" target="_blank">FormsGallery</a></format> sample.
-</para>
+    </para>
       <para>
         <img href="AbsoluteLayout.TripleScreenShot.png" />
       </para>
@@ -198,15 +158,15 @@ namespace AbsoluteLayoutDemo
         </list>
         <para>Application developers can use XAML to lay out elements with the <see cref="T:Xamarin.Forms.AbsoluteLayout" /> class. The example below places a blue <see cref="T:Xamarin.Forms.BoxView" /> inside an <see cref="T:Xamarin.Forms.AbsoluteLayout" />: </para>
         <code lang="XAML"><![CDATA[<AbsoluteLayout VerticalOptions="FillAndExpand"
-                HorizontalOptions="FillAndExpand">
-    <BoxView    AbsoluteLayout.LayoutBounds="0.25, 0.25, 0.5, 0.5"
-                Color="Blue"
-                AbsoluteLayout.LayoutFlags="All" />
-</AbsoluteLayout>
-]]></code>
+                    HorizontalOptions="FillAndExpand">
+        <BoxView    AbsoluteLayout.LayoutBounds="0.25, 0.25, 0.5, 0.5"
+                    Color="Blue"
+                    AbsoluteLayout.LayoutFlags="All" />
+    </AbsoluteLayout>
+    ]]></code>
       </example>
       <para>The <see cref="T:Xamarin.Forms.AbsoluteLayout" /> class can lay its child elements out in proportional units, device units, or a combination of both. Application developers should remember the following points when specifying a <see cref="T:Xamarin.Forms.Rectangle" /> structure that will define the layout bounds of a child element:
-        <list type="bullet"><item><term>For elements whose height and width fit on the screen, proportional position dimensions in the range [0,1] represent elements that are completely on the screen, regardless of whether the height, width, or both are specified in device or proportional units.</term></item><item><term>The above point means that, to specify an element in the lower right hand corner of the screen and that is half as wide and half as all as the screen, with a  <see cref="T:Xamarin.Forms.AbsoluteLayoutFlags" /> value of <c>All</c>, the application developer would specify "1.0, 1.0, 0.5, 0.5".</term></item><item><term>The app developer can inadvertently cause child elements for which one or both size dimensions were specified proportionally to be displayed partially off the screen, or hidden altogether, by specifying device-unit positions that do not leave enough room for the calculated size of the child.</term></item><item><term>Each part of the bounding <see cref="T:Xamarin.Forms.Rectangle" /> structure is interpreted according to the <see cref="T:Xamarin.Forms.AbsoluteLayoutFlags" /> value that controls it. A given rectangle might, for example, have an X-coordinate that is in device units, a Y-coordinate that is in proportional units, a height that is in proportional units, and a width that is in device units, or any other combination of device and proportional units. </term></item><item><term>Rectangles that, when interpreted by using the current <see cref="T:Xamarin.Forms.AbsoluteLayoutFlags" /> set on the child, represent bounding boxes that are partially or wholly off-screen—for example, by having a width that is larger than the screen width—may give unexpected results.</term></item></list></para>
+            <list type="bullet"><item><term>For elements whose height and width fit on the screen, proportional position dimensions in the range [0,1] represent elements that are completely on the screen, regardless of whether the height, width, or both are specified in device or proportional units.</term></item><item><term>The above point means that, to specify an element in the lower right hand corner of the screen and that is half as wide and half as all as the screen, with a  <see cref="T:Xamarin.Forms.AbsoluteLayoutFlags" /> value of <c>All</c>, the application developer would specify "1.0, 1.0, 0.5, 0.5".</term></item><item><term>The app developer can inadvertently cause child elements for which one or both size dimensions were specified proportionally to be displayed partially off the screen, or hidden altogether, by specifying device-unit positions that do not leave enough room for the calculated size of the child.</term></item><item><term>Each part of the bounding <see cref="T:Xamarin.Forms.Rectangle" /> structure is interpreted according to the <see cref="T:Xamarin.Forms.AbsoluteLayoutFlags" /> value that controls it. A given rectangle might, for example, have an X-coordinate that is in device units, a Y-coordinate that is in proportional units, a height that is in proportional units, and a width that is in device units, or any other combination of device and proportional units. </term></item><item><term>Rectangles that, when interpreted by using the current <see cref="T:Xamarin.Forms.AbsoluteLayoutFlags" /> set on the child, represent bounding boxes that are partially or wholly off-screen—for example, by having a width that is larger than the screen width—may give unexpected results.</term></item></list></para>
     </remarks>
   </Docs>
   <Members>
diff --git a/docs/Xamarin.Forms.Core/Xamarin.Forms/AppLinkEntry.xml b/docs/Xamarin.Forms.Core/Xamarin.Forms/AppLinkEntry.xml
index ab50ffa9..3d816067 100644
--- a/docs/Xamarin.Forms.Core/Xamarin.Forms/AppLinkEntry.xml
+++ b/docs/Xamarin.Forms.Core/Xamarin.Forms/AppLinkEntry.xml
@@ -15,8 +15,10 @@
   </Interfaces>
   <Docs>
     <summary>A deep application link in an app link search index.</summary>
-    <remarks>To be added.</remarks>
-    <related type="article" href="https://developer.xamarin.com/guides/xamarin-forms/working-with/deep-linking/">Application Indexing and Deep Linking</related>
+    <remarks>
+      <para>For information on setting up deep application linking on the Android platform (and on using deep linking in general), see <format type="text/html"><a href="https://developer.xamarin.com/guides/xamarin-forms/platform-features/deep-linking/">Application Indexing and Deep Linking</a></format>.</para>
+    </remarks>
+    <related type="article" href="https://developer.xamarin.com/guides/xamarin-forms/platform-features/deep-linking/">Application Indexing and Deep Linking</related>
   </Docs>
   <Members>
     <Member MemberName=".ctor">
diff --git a/docs/Xamarin.Forms.Core/Xamarin.Forms/Application.xml b/docs/Xamarin.Forms.Core/Xamarin.Forms/Application.xml
index 318ebb15..0bb70fa3 100644
--- a/docs/Xamarin.Forms.Core/Xamarin.Forms/Application.xml
+++ b/docs/Xamarin.Forms.Core/Xamarin.Forms/Application.xml
@@ -56,7 +56,7 @@
         <summary>Gets the object that developers use to register or unregister application links.</summary>
         <value>The object that developers use to register or unregister application links.</value>
         <remarks>It is not possible to unregister an app link on the Android platform.</remarks>
-        <related type="article" href="https://developer.xamarin.com/guides/xamarin-forms/working-with/deep-linking/">Application Indexing and Deep Linking</related>
+        <related type="article" href="https://developer.xamarin.com/guides/xamarin-forms/platform-features/deep-linking/">Application Indexing and Deep Linking</related>
       </Docs>
     </Member>
     <Member MemberName="ClearCurrent">
@@ -280,7 +280,7 @@
         <param name="uri">The URI for the request.</param>
         <summary>App developers override this method to respond when the user initiates an app link request.</summary>
         <remarks>To be added.</remarks>
-        <related type="article" href="https://developer.xamarin.com/guides/xamarin-forms/working-with/deep-linking/">Application Indexing and Deep Linking</related>
+        <related type="article" href="https://developer.xamarin.com/guides/xamarin-forms/platform-features/deep-linking/">Application Indexing and Deep Linking</related>
       </Docs>
     </Member>
     <Member MemberName="OnParentSet">
diff --git a/docs/Xamarin.Forms.Core/Xamarin.Forms/Behavior.xml b/docs/Xamarin.Forms.Core/Xamarin.Forms/Behavior.xml
index 2649043a..123f2d0e 100644
--- a/docs/Xamarin.Forms.Core/Xamarin.Forms/Behavior.xml
+++ b/docs/Xamarin.Forms.Core/Xamarin.Forms/Behavior.xml
@@ -17,6 +17,7 @@
   <Docs>
     <summary>Base class for generalized user-defined behaviors that can respond to arbitrary conditions and events.</summary>
     <remarks>Application developers should specialize the <see cref="T:Xamarin.Forms.Behavior`1" /> generic class, instead of directly using <see cref="T:Xamarin.Forms.Behavior" />.</remarks>
+    <related type="article" href="https://developer.xamarin.com/guides/xamarin-forms/application-fundamentals/behaviors/creating/">Xamarin.Forms Behaviors</related>
   </Docs>
   <Members>
     <Member MemberName="AssociatedType">
diff --git a/docs/Xamarin.Forms.Core/Xamarin.Forms/Behavior`1.xml b/docs/Xamarin.Forms.Core/Xamarin.Forms/Behavior`1.xml
index b45d2110..e5a32feb 100644
--- a/docs/Xamarin.Forms.Core/Xamarin.Forms/Behavior`1.xml
+++ b/docs/Xamarin.Forms.Core/Xamarin.Forms/Behavior`1.xml
@@ -24,6 +24,7 @@
     <typeparam name="T">The type of the objects with which this <see cref="T:Xamarin.Forms.Behavior`1" /> can be associated.</typeparam>
     <summary>Base generic class for generalized user-defined behaviors that can respond to arbitrary conditions and events.</summary>
     <remarks>Application developers should specialize this generic class, instead of directly using <see cref="T:Xamarin.Forms.Behavior" />.</remarks>
+    <related type="article" href="https://developer.xamarin.com/guides/xamarin-forms/application-fundamentals/behaviors/creating/">Xamarin.Forms Behaviors</related>
   </Docs>
   <Members>
     <Member MemberName=".ctor">
diff --git a/docs/Xamarin.Forms.Core/Xamarin.Forms/BindableProperty.xml b/docs/Xamarin.Forms.Core/Xamarin.Forms/BindableProperty.xml
index 0f9f4210..7baddef0 100644
--- a/docs/Xamarin.Forms.Core/Xamarin.Forms/BindableProperty.xml
+++ b/docs/Xamarin.Forms.Core/Xamarin.Forms/BindableProperty.xml
@@ -60,9 +60,9 @@
         <param name="declaringType">The type of the declaring object.</param>
         <param name="defaultValue">The default value for the property.</param>
         <param name="defaultBindingMode">The BindingMode to use on SetBinding() if no BindingMode is given. This parameter is optional. Default is BindingMode.OneWay.</param>
-        <param name="validateValue">A delegate to be ran when a value is set. This parameter is optional. Default is null.</param>
-        <param name="propertyChanged">A delegate to be ran when the value has changed. This parameter is optional. Default is null.</param>
-        <param name="propertyChanging">A delegate to be ran when the value will change. This parameter is optional. Default is null.</param>
+        <param name="validateValue">A delegate to be run when a value is set. This parameter is optional. Default is null.</param>
+        <param name="propertyChanged">A delegate to be run when the value has changed. This parameter is optional. Default is null.</param>
+        <param name="propertyChanging">A delegate to be run when the value will change. This parameter is optional. Default is null.</param>
         <param name="coerceValue">A delegate used to coerce the range of a value. This parameter is optional. Default is null.</param>
         <summary>Creates a new instance of the BindableProperty class.</summary>
         <returns>A newly created BindableProperty.</returns>
@@ -102,9 +102,9 @@
         <param name="declaringType">The type of the declaring object.</param>
         <param name="defaultValue">The default value for the property.</param>
         <param name="defaultBindingMode">The BindingMode to use on SetBinding() if no BindingMode is given. This parameter is optional. Default is BindingMode.OneWay.</param>
-        <param name="validateValue">A delegate to be ran when a value is set. This parameter is optional. Default is null.</param>
-        <param name="propertyChanged">A delegate to be ran when the value has changed. This parameter is optional. Default is null.</param>
-        <param name="propertyChanging">A delegate to be ran when the value will change. This parameter is optional. Default is null.</param>
+        <param name="validateValue">A delegate to be run when a value is set. This parameter is optional. Default is null.</param>
+        <param name="propertyChanged">A delegate to be run when the value has changed. This parameter is optional. Default is null.</param>
+        <param name="propertyChanging">A delegate to be run when the value will change. This parameter is optional. Default is null.</param>
         <param name="coerceValue">To be added.</param>
         <param name="defaultValueCreator">A Func used to initialize default value for reference types..</param>
         <summary>Creates a new instance of the BindableProperty class.</summary>
@@ -147,7 +147,7 @@
         <param name="getter">An expression identifying the getter for the property using this BindableProperty as backing store.</param>
         <param name="defaultValue">Default value for the BindableProperty.</param>
         <param name="defaultBindingMode">The BindingMode to use on SetBinding() if no BindingMode is given. This parameter is optional. Default is BindingMode.OneWay.</param>
-        <param name="validateValue">A delegate to be ran when a value is set. This parameter is optional. Default is null.</param>
+        <param name="validateValue">A delegate to be run when a value is set. This parameter is optional. Default is null.</param>
         <param name="propertyChanged">To be added.</param>
         <param name="propertyChanging">To be added.</param>
         <param name="coerceValue">A delegate used to coerce the range of a value. This parameter is optional. Default is null.</param>
@@ -199,7 +199,7 @@
         <param name="getter">An expression identifying the getter for the property using this BindableProperty as backing store.</param>
         <param name="defaultValue">Default value for the BindableProperty.</param>
         <param name="defaultBindingMode">The BindingMode to use on SetBinding() if no BindingMode is given. This parameter is optional. Default is BindingMode.OneWay.</param>
-        <param name="validateValue">A delegate to be ran when a value is set. This parameter is optional. Default is null.</param>
+        <param name="validateValue">A delegate to be run when a value is set. This parameter is optional. Default is null.</param>
         <param name="propertyChanged">To be added.</param>
         <param name="propertyChanging">To be added.</param>
         <param name="coerceValue">To be added.</param>
@@ -237,9 +237,9 @@
         <param name="declaringType">The type of the declaring object.</param>
         <param name="defaultValue">The default value for the property.</param>
         <param name="defaultBindingMode">The BindingMode to use on SetBinding() if no BindingMode is given. This parameter is optional. Default is BindingMode.OneWay.</param>
-        <param name="validateValue">A delegate to be ran when a value is set. This parameter is optional. Default is null.</param>
-        <param name="propertyChanged">A delegate to be ran when the value has changed. This parameter is optional. Default is null.</param>
-        <param name="propertyChanging">A delegate to be ran when the value will change. This parameter is optional. Default is null.</param>
+        <param name="validateValue">A delegate to be run when a value is set. This parameter is optional. Default is null.</param>
+        <param name="propertyChanged">A delegate to be run when the value has changed. This parameter is optional. Default is null.</param>
+        <param name="propertyChanging">A delegate to be run when the value will change. This parameter is optional. Default is null.</param>
         <param name="coerceValue">A delegate used to coerce the range of a value. This parameter is optional. Default is null.</param>
         <summary>Creates a new instance of the BindableProperty class for an attached property.</summary>
         <returns>A newly created attached BindableProperty.</returns>
@@ -279,9 +279,9 @@
         <param name="declaringType">The type of the declaring object.</param>
         <param name="defaultValue">The default value for the property.</param>
         <param name="defaultBindingMode">The BindingMode to use on SetBinding() if no BindingMode is given. This parameter is optional. Default is BindingMode.OneWay.</param>
-        <param name="validateValue">A delegate to be ran when a value is set. This parameter is optional. Default is null.</param>
-        <param name="propertyChanged">A delegate to be ran when the value has changed. This parameter is optional. Default is null.</param>
-        <param name="propertyChanging">A delegate to be ran when the value will change. This parameter is optional. Default is null.</param>
+        <param name="validateValue">A delegate to be run when a value is set. This parameter is optional. Default is null.</param>
+        <param name="propertyChanged">A delegate to be run when the value has changed. This parameter is optional. Default is null.</param>
+        <param name="propertyChanging">A delegate to be run when the value will change. This parameter is optional. Default is null.</param>
         <param name="coerceValue">A delegate used to coerce the range of a value. This parameter is optional. Default is null.</param>
         <param name="defaultValueCreator">A Func used to initialize default value for reference types..</param>
         <summary>Creates a new instance of the BindableProperty class for an attached property.</summary>
@@ -321,7 +321,7 @@
         <param name="staticgetter">An expression identifying a static method returning the value of the property using this BindableProperty as backing store.</param>
         <param name="defaultValue">Default value for the BindableProperty.</param>
         <param name="defaultBindingMode">The BindingMode to use on SetBinding() if no BindingMode is given. This parameter is optional. Default is BindingMode.OneWay.</param>
-        <param name="validateValue">A delegate to be ran when a value is set. This parameter is optional. Default is null.</param>
+        <param name="validateValue">A delegate to be run when a value is set. This parameter is optional. Default is null.</param>
         <param name="propertyChanged">To be added.</param>
         <param name="propertyChanging">To be added.</param>
         <param name="coerceValue">A delegate used to coerce the range of a value. This parameter is optional. Default is null.</param>
@@ -371,7 +371,7 @@
         <param name="staticgetter">An expression identifying a static method returning the value of the property using this BindableProperty as backing store.</param>
         <param name="defaultValue">Default value for the BindableProperty.</param>
         <param name="defaultBindingMode">The BindingMode to use on SetBinding() if no BindingMode is given. This parameter is optional. Default is BindingMode.OneWay.</param>
-        <param name="validateValue">A delegate to be ran when a value is set. This parameter is optional. Default is null.</param>
+        <param name="validateValue">A delegate to be run when a value is set. This parameter is optional. Default is null.</param>
         <param name="propertyChanged">To be added.</param>
         <param name="propertyChanging">To be added.</param>
         <param name="coerceValue">A delegate used to coerce the range of a value. This parameter is optional. Default is null.</param>
@@ -410,9 +410,9 @@
         <param name="declaringType">The type of the declaring object.</param>
         <param name="defaultValue">The default value for the property.</param>
         <param name="defaultBindingMode">The BindingMode to use on SetBinding() if no BindingMode is given. This parameter is optional. Default is BindingMode.OneWay.</param>
-        <param name="validateValue">A delegate to be ran when a value is set. This parameter is optional. Default is null.</param>
-        <param name="propertyChanged">A delegate to be ran when the value has changed. This parameter is optional. Default is null.</param>
-        <param name="propertyChanging">A delegate to be ran when the value will change. This parameter is optional. Default is null.</param>
+        <param name="validateValue">A delegate to be run when a value is set. This parameter is optional. Default is null.</param>
+        <param name="propertyChanged">A delegate to be run when the value has changed. This parameter is optional. Default is null.</param>
+        <param name="propertyChanging">A delegate to be run when the value will change. This parameter is optional. Default is null.</param>
         <param name="coerceValue">A delegate used to coerce the range of a value. This parameter is optional. Default is null.</param>
         <summary>Creates a new instance of the BindableProperty class for attached read-only properties.</summary>
         <returns>A newly created attached read-only BindableProperty.</returns>
@@ -453,9 +453,9 @@
         <param name="declaringType">The type of the declaring object.</param>
         <param name="defaultValue">The default value for the property.</param>
         <param name="defaultBindingMode">The BindingMode to use on SetBinding() if no BindingMode is given. This parameter is optional. Default is BindingMode.OneWay.</param>
-        <param name="validateValue">A delegate to be ran when a value is set. This parameter is optional. Default is null.</param>
-        <param name="propertyChanged">A delegate to be ran when the value has changed. This parameter is optional. Default is null.</param>
-        <param name="propertyChanging">A delegate to be ran when the value will change. This parameter is optional. Default is null.</param>
+        <param name="validateValue">A delegate to be run when a value is set. This parameter is optional. Default is null.</param>
+        <param name="propertyChanged">A delegate to be run when the value has changed. This parameter is optional. Default is null.</param>
+        <param name="propertyChanging">A delegate to be run when the value will change. This parameter is optional. Default is null.</param>
         <param name="coerceValue">A delegate used to coerce the range of a value. This parameter is optional. Default is null.</param>
         <param name="defaultValueCreator">A Func used to initialize default value for reference types.</param>
         <summary>Creates a new instance of the BindableProperty class for attached read-only properties.</summary>
@@ -496,7 +496,7 @@
         <param name="staticgetter">An expression identifying a static method returning the value of the property using this BindableProperty as backing store.</param>
         <param name="defaultValue">Default value for the BindableProperty.</param>
         <param name="defaultBindingMode">The BindingMode to use on SetBinding() if no BindingMode is given. This parameter is optional. Default is BindingMode.OneWay.</param>
-        <param name="validateValue">A delegate to be ran when a value is set. This parameter is optional. Default is null.</param>
+        <param name="validateValue">A delegate to be run when a value is set. This parameter is optional. Default is null.</param>
         <param name="propertyChanged">To be added.</param>
         <param name="propertyChanging">To be added.</param>
         <param name="coerceValue">A delegate used to coerce the range of a value. This parameter is optional. Default is null.</param>
@@ -546,7 +546,7 @@
         <param name="staticgetter">An expression identifying a static method returning the value of the property using this BindableProperty as backing store.</param>
         <param name="defaultValue">Default value for the BindableProperty.</param>
         <param name="defaultBindingMode">The BindingMode to use on SetBinding() if no BindingMode is given. This parameter is optional. Default is BindingMode.OneWay.</param>
-        <param name="validateValue">A delegate to be ran when a value is set. This parameter is optional. Default is null.</param>
+        <param name="validateValue">A delegate to be run when a value is set. This parameter is optional. Default is null.</param>
         <param name="propertyChanged">To be added.</param>
         <param name="propertyChanging">To be added.</param>
         <param name="coerceValue">A delegate used to coerce the range of a value. This parameter is optional. Default is null.</param>
@@ -586,7 +586,7 @@
         <param name="declaringType">The type of the declaring object.</param>
         <param name="defaultValue">The default value for the property.</param>
         <param name="defaultBindingMode">The BindingMode to use on SetBinding() if no BindingMode is given. This parameter is optional. Default is BindingMode.OneWay.</param>
-        <param name="validateValue">A delegate to be ran when a value is set. This parameter is optional. Default is null.</param>
+        <param name="validateValue">A delegate to be run when a value is set. This parameter is optional. Default is null.</param>
         <param name="propertyChanged">To be added.</param>
         <param name="propertyChanging">To be added.</param>
         <param name="coerceValue">A delegate used to coerce the range of a value. This parameter is optional. Default is null.</param>
@@ -630,7 +630,7 @@
         <param name="declaringType">The type of the declaring object.</param>
         <param name="defaultValue">The default value for the property.</param>
         <param name="defaultBindingMode">The BindingMode to use on SetBinding() if no BindingMode is given. This parameter is optional. Default is BindingMode.OneWay.</param>
-        <param name="validateValue">A delegate to be ran when a value is set. This parameter is optional. Default is null.</param>
+        <param name="validateValue">A delegate to be run when a value is set. This parameter is optional. Default is null.</param>
         <param name="propertyChanged">To be added.</param>
         <param name="propertyChanging">To be added.</param>
         <param name="coerceValue">A delegate used to coerce the range of a value. This parameter is optional. Default is null.</param>
@@ -678,9 +678,9 @@
         <param name="getter">An expression identifying the getter for the property using this BindableProperty as backing store.</param>
         <param name="defaultValue">Default value for the BindableProperty.</param>
         <param name="defaultBindingMode">The BindingMode to use on SetBinding() if no BindingMode is given. This parameter is optional. Default is BindingMode.OneWay.</param>
-        <param name="validateValue">A delegate to be ran when a value is set. This parameter is optional. Default is null.</param>
-        <param name="propertyChanged">A delegate to be ran when the value has changed. This parameter is optional. Default is null.</param>
-        <param name="propertyChanging">A delegate to be ran when the value will change. This parameter is optional. Default is null.</param>
+        <param name="validateValue">A delegate to be run when a value is set. This parameter is optional. Default is null.</param>
+        <param name="propertyChanged">A delegate to be run when the value has changed. This parameter is optional. Default is null.</param>
+        <param name="propertyChanging">A delegate to be run when the value will change. This parameter is optional. Default is null.</param>
         <param name="coerceValue">A delegate used to coerce the range of a value. This parameter is optional. Default is null.</param>
         <summary>Deprecated. Do not use.</summary>
         <returns>A newly created BindablePropertyKey.</returns>
@@ -732,9 +732,9 @@
         <param name="getter">An expression identifying the getter for the property using this BindableProperty as backing store.</param>
         <param name="defaultValue">Default value for the BindableProperty.</param>
         <param name="defaultBindingMode">The BindingMode to use on SetBinding() if no BindingMode is given. This parameter is optional. Default is BindingMode.OneWay.</param>
-        <param name="validateValue">A delegate to be ran when a value is set. This parameter is optional. Default is null.</param>
-        <param name="propertyChanged">A delegate to be ran when the value has changed. This parameter is optional. Default is null.</param>
-        <param name="propertyChanging">A delegate to be ran when the value will change. This parameter is optional. Default is null.</param>
+        <param name="validateValue">A delegate to be run when a value is set. This parameter is optional. Default is null.</param>
+        <param name="propertyChanged">A delegate to be run when the value has changed. This parameter is optional. Default is null.</param>
+        <param name="propertyChanging">A delegate to be run when the value will change. This parameter is optional. Default is null.</param>
         <param name="coerceValue">A delegate used to coerce the range of a value. This parameter is optional. Default is null.</param>
         <param name="defaultValueCreator">A Func used to initialize default value for reference types.</param>
         <summary>Deprecated. Do not use.</summary>
-- 
cgit v1.2.3