SolidColorBrush.Content is the ContentProperty of the class (#1776)

davidbritch · web-flow · commit 6135b8f479b2 · 2023-10-09T10:02:07.000+01:00
* SolidColorBrush.Content is the ContentProperty of the class.

* Fix linter error.
diff --git a/docs/fundamentals/controltemplate.md b/docs/fundamentals/controltemplate.md
@@ -162,7 +162,7 @@ The [`TemplateBinding`](xref:Microsoft.Maui.Controls.Xaml.TemplateBindingExtensi
 - <xref:Microsoft.Maui.Controls.Xaml.TemplateBindingExtension.ConverterParameter>, of type `object`, the parameter to the binding value converter.
 - <xref:Microsoft.Maui.Controls.Xaml.TemplateBindingExtension.StringFormat>, of type `string`, the string format for the binding.
 
-The `ContentProperty` for the [`TemplateBinding`](xref:Microsoft.Maui.Controls.Xaml.TemplateBindingExtension) markup extension is <xref:Microsoft.Maui.Controls.Xaml.TemplateBindingExtension.Path>. Therefore, the "Path=" part of the markup extension can be omitted if the path is the first item in the [`TemplateBinding`](xref:Microsoft.Maui.Controls.Xaml.TemplateBindingExtension) expression. For more information about using these properties in a binding expression, see [Data binding](~/fundamentals/data-binding/index.md).
+The [`ContentProperty`](xref:Microsoft.Maui.Controls.ContentPropertyAttribute) for the [`TemplateBinding`](xref:Microsoft.Maui.Controls.Xaml.TemplateBindingExtension) markup extension is <xref:Microsoft.Maui.Controls.Xaml.TemplateBindingExtension.Path>. Therefore, the "Path=" part of the markup extension can be omitted if the path is the first item in the [`TemplateBinding`](xref:Microsoft.Maui.Controls.Xaml.TemplateBindingExtension) expression. For more information about using these properties in a binding expression, see [Data binding](~/fundamentals/data-binding/index.md).
 
 > [!WARNING]
 > The [`TemplateBinding`](xref:Microsoft.Maui.Controls.Xaml.TemplateBindingExtension) markup extension should only be used within a <xref:Microsoft.Maui.Controls.ControlTemplate>. However, attempting to use a [`TemplateBinding`](xref:Microsoft.Maui.Controls.Xaml.TemplateBindingExtension) expression outside of a <xref:Microsoft.Maui.Controls.ControlTemplate> will not result in a build error or an exception being thrown.
diff --git a/docs/user-interface/brushes/gradient.md b/docs/user-interface/brushes/gradient.md
@@ -18,7 +18,7 @@ Classes that derive from <xref:Microsoft.Maui.Controls.GradientBrush> describe d
 The <xref:Microsoft.Maui.Controls.GradientBrush> class defines the <xref:Microsoft.Maui.Controls.GradientBrush.GradientStops> property, of type <xref:Microsoft.Maui.Controls.GradientStopCollection>, which represents the brush's gradient stops, each of which specifies a color and an offset along the brush's gradient axis. A <xref:Microsoft.Maui.Controls.GradientStopCollection> is an `ObservableCollection` of <xref:Microsoft.Maui.Controls.GradientStop> objects. The <xref:Microsoft.Maui.Controls.GradientBrush.GradientStops> property is backed by a <xref:Microsoft.Maui.Controls.BindableProperty> object, which means that it can be the target of data bindings, and styled.
 
 > [!NOTE]
-> The <xref:Microsoft.Maui.Controls.GradientBrush.GradientStops> property is the `ContentProperty` of the <xref:Microsoft.Maui.Controls.GradientBrush> class, and so does not need to be explicitly set from XAML.
+> The <xref:Microsoft.Maui.Controls.GradientBrush.GradientStops> property is the [`ContentProperty`](xref:Microsoft.Maui.Controls.ContentPropertyAttribute) of the <xref:Microsoft.Maui.Controls.GradientBrush> class, and so does not need to be explicitly set from XAML.
 
 ## Gradient stops
 
diff --git a/docs/user-interface/brushes/solidcolor.md b/docs/user-interface/brushes/solidcolor.md
@@ -10,8 +10,18 @@ ms.date: 01/11/2022
 
 The .NET Multi-platform App UI (.NET MAUI) <xref:Microsoft.Maui.Controls.SolidColorBrush> class derives from the <xref:Microsoft.Maui.Controls.Brush> class, and is used to paint an area with a solid color. There are a variety of approaches to specifying the color of a <xref:Microsoft.Maui.Controls.SolidColorBrush>. For example, you can specify its color with a <xref:Microsoft.Maui.Graphics.Color> value or by using one of the predefined <xref:Microsoft.Maui.Controls.SolidColorBrush> objects provided by the <xref:Microsoft.Maui.Controls.Brush> class.
 
+::: moniker range="=net-maui-7.0"
+
 The <xref:Microsoft.Maui.Controls.SolidColorBrush> class defines the `Color` property, of type <xref:Microsoft.Maui.Graphics.Color>, which represents the color of the brush. This property is backed by a <xref:Microsoft.Maui.Controls.BindableProperty> object, which means that it can be the target of data bindings, and styled.
 
+::: moniker-end
+
+::: moniker range=">=net-maui-8.0"
+
+The <xref:Microsoft.Maui.Controls.SolidColorBrush> class defines the `Color` property, of type <xref:Microsoft.Maui.Graphics.Color>, which represents the color of the brush. This property is the [`ContentProperty`](xref:Microsoft.Maui.Controls.ContentPropertyAttribute) of the <xref:Microsoft.Maui.Controls.SolidColorBrush> class, and therefore does not need to be explicitly set from XAML. In addition, this property is backed by a <xref:Microsoft.Maui.Controls.BindableProperty> object, which means that it can be the target of data bindings, and styled.
+
+::: moniker-end
+
 The <xref:Microsoft.Maui.Controls.SolidColorBrush> class also has an `IsEmpty` method that returns a `bool` that represents whether the brush has been assigned a color.
 
 ## Create a SolidColorBrush
diff --git a/docs/user-interface/controls/border.md b/docs/user-interface/controls/border.md
@@ -12,7 +12,7 @@ The .NET Multi-platform App UI (.NET MAUI) <xref:Microsoft.Maui.Controls.Border>
 
 <xref:Microsoft.Maui.Controls.Border> defines the following properties:
 
-- `Content`, of type `IView`, represents the content to display in the border. This property is the `ContentProperty` of the <xref:Microsoft.Maui.Controls.Border> class, and therefore does not need to be explicitly set from XAML.
+- `Content`, of type `IView`, represents the content to display in the border. This property is the [`ContentProperty`](xref:Microsoft.Maui.Controls.ContentPropertyAttribute) of the <xref:Microsoft.Maui.Controls.Border> class, and therefore does not need to be explicitly set from XAML.
 - `Padding`, of type `Thickness`, represents the distance between the border and its child element.
 - `StrokeShape`, of type `IShape`, describes the shape of the border. This property has a type converter applied to it that can convert a string to its equivalent `IShape`. It's default value is <xref:Microsoft.Maui.Controls.Shapes.Rectangle>. Therefore, a <xref:Microsoft.Maui.Controls.Border> will be rectangular by default.
 - `Stroke`, of type <xref:Microsoft.Maui.Controls.Brush>, indicates the brush used to paint the border.
diff --git a/docs/user-interface/controls/frame.md b/docs/user-interface/controls/frame.md
@@ -16,7 +16,7 @@ The <xref:Microsoft.Maui.Controls.Frame> class defines the following properties:
 
 These properties are backed by <xref:Microsoft.Maui.Controls.BindableProperty> objects, which means that they can be targets of data bindings, and styled.
 
-The <xref:Microsoft.Maui.Controls.Frame> class inherits from <xref:Microsoft.Maui.Controls.ContentView>, which provides a `Content` bindable property. The `Content` property is the `ContentProperty` of the <xref:Microsoft.Maui.Controls.Frame> class, and therefore does not need to be explicitly set from XAML.
+The <xref:Microsoft.Maui.Controls.Frame> class inherits from <xref:Microsoft.Maui.Controls.ContentView>, which provides a `Content` bindable property. The `Content` property is the [`ContentProperty`](xref:Microsoft.Maui.Controls.ContentPropertyAttribute) of the <xref:Microsoft.Maui.Controls.Frame> class, and therefore does not need to be explicitly set from XAML.
 
 > [!NOTE]
 > The <xref:Microsoft.Maui.Controls.Frame> class existed in Xamarin.Forms and is present in .NET MAUI for users who are migrating their apps from Xamarin.Forms to .NET MAUI. If you're building a new .NET MAUI app it's recommended to use <xref:Microsoft.Maui.Controls.Border> instead, and to set shadows using the `Shadow` bindable property on <xref:Microsoft.Maui.Controls.VisualElement>. For more information, see [Border](border.md) and [Shadow](../shadow.md).
diff --git a/docs/user-interface/controls/label.md b/docs/user-interface/controls/label.md
@@ -186,7 +186,7 @@ Alternatively, for greater readability the HTML can be inlined in a `CDATA` sect
 </Label>
 ```
 
-In this example, the `Text` property is set to the HTML string that's inlined in the `CDATA` section. This works because the `Text` property is the `ContentProperty` for the <xref:Microsoft.Maui.Controls.Label> class.
+In this example, the `Text` property is set to the HTML string that's inlined in the `CDATA` section. This works because the `Text` property is the [`ContentProperty`](xref:Microsoft.Maui.Controls.ContentPropertyAttribute) for the <xref:Microsoft.Maui.Controls.Label> class.
 
 > [!IMPORTANT]
 > Displaying HTML in a <xref:Microsoft.Maui.Controls.Label> is limited to the HTML tags that are supported by the underlying platform.
diff --git a/docs/user-interface/controls/scrollview.md b/docs/user-interface/controls/scrollview.md
@@ -22,7 +22,7 @@ The .NET Multi-platform App UI (.NET MAUI) <xref:Microsoft.Maui.Controls.ScrollV
 
 These properties are backed by <xref:Microsoft.Maui.Controls.BindableProperty> objects, with the exception of the `Content` property, which means that they can be targets of data bindings and styled.
 
-The `Content` property is the `ContentProperty` of the <xref:Microsoft.Maui.Controls.ScrollView> class, and therefore does not need to be explicitly set from XAML.
+The `Content` property is the [`ContentProperty`](xref:Microsoft.Maui.Controls.ContentPropertyAttribute) of the <xref:Microsoft.Maui.Controls.ScrollView> class, and therefore does not need to be explicitly set from XAML.
 
 > [!WARNING]
 > <xref:Microsoft.Maui.Controls.ScrollView> objects should not be nested. In addition, <xref:Microsoft.Maui.Controls.ScrollView> objects should not be nested with other controls that provide scrolling, such as <xref:Microsoft.Maui.Controls.CollectionView>, <xref:Microsoft.Maui.Controls.ListView>, and <xref:Microsoft.Maui.Controls.WebView>.
diff --git a/docs/user-interface/controls/shapes/geometries.md b/docs/user-interface/controls/shapes/geometries.md
@@ -127,7 +127,7 @@ These properties are backed by <xref:Microsoft.Maui.Controls.BindableProperty> o
 For more information about the <xref:Microsoft.Maui.Controls.Shapes.FillRule> enumeration, see [.NET MAUI Shapes: Fill rules](fillrules.md).
 
 > [!NOTE]
-> The <xref:Microsoft.Maui.Controls.Shapes.PathGeometry.Figures> property is the `ContentProperty` of the <xref:Microsoft.Maui.Controls.Shapes.PathGeometry> class, and so does not need to be explicitly set from XAML.
+> The <xref:Microsoft.Maui.Controls.Shapes.PathGeometry.Figures> property is the [`ContentProperty`](xref:Microsoft.Maui.Controls.ContentPropertyAttribute) of the <xref:Microsoft.Maui.Controls.Shapes.PathGeometry> class, and so does not need to be explicitly set from XAML.
 
 A <xref:Microsoft.Maui.Controls.Shapes.PathGeometry> is made up of a collection of <xref:Microsoft.Maui.Controls.Shapes.PathFigure> objects, with each <xref:Microsoft.Maui.Controls.Shapes.PathFigure> describing a shape in the geometry. Each <xref:Microsoft.Maui.Controls.Shapes.PathFigure> is itself comprised of one or more <xref:Microsoft.Maui.Controls.Shapes.PathSegment> objects, each of which describes a segment of the shape. There are many types of segments:
 
@@ -539,7 +539,7 @@ The <xref:Microsoft.Maui.Controls.Shapes.GeometryGroup> class defines the follow
 These properties are backed by <xref:Microsoft.Maui.Controls.BindableProperty> objects, which means that they can be targets of data bindings, and styled.
 
 > [!NOTE]
-> The `Children` property is the `ContentProperty` of the <xref:Microsoft.Maui.Controls.Shapes.GeometryGroup> class, and so does not need to be explicitly set from XAML.
+> The `Children` property is the [`ContentProperty`](xref:Microsoft.Maui.Controls.ContentPropertyAttribute) of the <xref:Microsoft.Maui.Controls.Shapes.GeometryGroup> class, and so does not need to be explicitly set from XAML.
 
 For more information about the <xref:Microsoft.Maui.Controls.Shapes.FillRule> enumeration, see [Fill rules](fillrules.md).
 
diff --git a/docs/user-interface/pages/tabbedpage.md b/docs/user-interface/pages/tabbedpage.md
@@ -58,7 +58,7 @@ A <xref:Microsoft.Maui.Controls.TabbedPage> can be populated with a collection o
 </TabbedPage>
 ```
 
-<xref:Microsoft.Maui.Controls.Page> objects that are added as child elements of <xref:Microsoft.Maui.Controls.TabbedPage> are added to the `Children` collection. The `Children` property of the `MultiPage<T>` class, from which <xref:Microsoft.Maui.Controls.TabbedPage> derives, is the `ContentProperty` of `MultiPage<T>`. Therefore, in XAML it's not necessary to explicitly assign the <xref:Microsoft.Maui.Controls.Page> objects to the `Children` property.
+<xref:Microsoft.Maui.Controls.Page> objects that are added as child elements of <xref:Microsoft.Maui.Controls.TabbedPage> are added to the `Children` collection. The `Children` property of the `MultiPage<T>` class, from which <xref:Microsoft.Maui.Controls.TabbedPage> derives, is the [`ContentProperty`](xref:Microsoft.Maui.Controls.ContentPropertyAttribute) of `MultiPage<T>`. Therefore, in XAML it's not necessary to explicitly assign the <xref:Microsoft.Maui.Controls.Page> objects to the `Children` property.
 
 The following screenshot shows the appearance of the resulting tab bar on the <xref:Microsoft.Maui.Controls.TabbedPage>:
 
diff --git a/docs/whats-new/dotnet-8.md b/docs/whats-new/dotnet-8.md
@@ -20,6 +20,7 @@ For information about what's new in .NET 8, see [What's new in .NET 8](/dotnet/c
 - <xref:Microsoft.Maui.Controls.PointerGestureRecognizer> gains `PointerPressedCommand`, `PointerPressedCommandParameter`, `PointerReleasedCommand`, `PointerReleasedCommandParameter` properties, and `PointerPressed` and `PointerReleased` events. For more information, see [Recognize a pointer gesture](~/fundamentals/gestures/pointer.md).
 - <xref:Microsoft.Maui.Devices.Flashlight> gains a `IsSupportedAsync` method that determines whether a flashlight is available on the device. For more information, see [Flashlight](~/platform-integration/device/flashlight.md).
 - <xref:Microsoft.Maui.Devices.Sensors.SensorSpeed> intervals have been unified across all platforms. For more information, see [Accessing device sensors](~/platform-integration/device/sensors.md).
+- <xref:Microsoft.Maui.Controls.SolidColorBrush.Color> is the [`ContentProperty`](xref:Microsoft.Maui.Controls.ContentPropertyAttribute) of the <xref:Microsoft.Maui.Controls.SolidColorBrush> class, and therefore does not need to be explicitly set from XAML.
 
 The following members have been deprecated:
 
diff --git a/docs/xaml/fundamentals/data-binding-basics.md b/docs/xaml/fundamentals/data-binding-basics.md
@@ -53,9 +53,9 @@ The following example contains a <xref:Microsoft.Maui.Controls.Slider> and two <
 </ContentPage>
 ```
 
-The <xref:Microsoft.Maui.Controls.Slider> contains an `x:Name` attribute that is referenced by the two <xref:Microsoft.Maui.Controls.Label> views using the `x:Reference` markup extension. The `x:Reference` binding extension defines a property named `Name` to set to the name of the referenced element, in this case `slider`. However, the `ReferenceExtension` class that defines the `x:Reference` markup extension also defines a `ContentProperty` attribute for `Name`, which means that it isn’t explicitly required.
+The <xref:Microsoft.Maui.Controls.Slider> contains an `x:Name` attribute that is referenced by the two <xref:Microsoft.Maui.Controls.Label> views using the `x:Reference` markup extension. The `x:Reference` binding extension defines a property named `Name` to set to the name of the referenced element, in this case `slider`. However, the `ReferenceExtension` class that defines the `x:Reference` markup extension also defines a [`ContentProperty`](xref:Microsoft.Maui.Controls.ContentPropertyAttribute) attribute for `Name`, which means that it isn’t explicitly required.
 
-The `Binding` markup extension itself can have several properties, just like the `BindingBase` and `Binding` class. The `ContentProperty` for `Binding` is `Path`, but the “Path=” part of the markup extension can be omitted if the path is the first item in the `Binding` markup extension.
+The `Binding` markup extension itself can have several properties, just like the `BindingBase` and `Binding` class. The [`ContentProperty`](xref:Microsoft.Maui.Controls.ContentPropertyAttribute) for `Binding` is `Path`, but the “Path=” part of the markup extension can be omitted if the path is the first item in the `Binding` markup extension.
 
 The second `Binding` markup extension sets the `StringFormat` property. In .NET MAUI, bindings do not perform any implicit type conversions, and if you need to display a non-string object as a string you must provide a type converter or use `StringFormat`.
 
diff --git a/docs/xaml/fundamentals/essential-syntax.md b/docs/xaml/fundamentals/essential-syntax.md
@@ -173,7 +173,7 @@ In the previous example, the <xref:Microsoft.Maui.Controls.Grid> object was set
 </ContentPage>
 ```
 
-The `Content` property isn't required in XAML because elements defined for use in .NET MAUI XAML are allowed to have one property specified as the `ContentProperty` attribute on the class:
+The `Content` property isn't required in XAML because elements defined for use in .NET MAUI XAML are allowed to have one property specified as the [`ContentProperty`](xref:Microsoft.Maui.Controls.ContentPropertyAttribute) attribute on the class:
 
 ```csharp
 [ContentProperty("Content")]
@@ -183,9 +183,9 @@ public class ContentPage : TemplatedPage
 }
 ```
 
-Any property specified as the `ContentProperty` of a class means that the property-element tags for the property are not required. Therefore, the example above specifies that any XAML content that appears between the start and end <xref:Microsoft.Maui.Controls.ContentPage> tags is assigned to the `Content` property.
+Any property specified as the [`ContentProperty`](xref:Microsoft.Maui.Controls.ContentPropertyAttribute) of a class means that the property-element tags for the property are not required. Therefore, the example above specifies that any XAML content that appears between the start and end <xref:Microsoft.Maui.Controls.ContentPage> tags is assigned to the `Content` property.
 
-Many classes also have `ContentProperty` attribute definitions. For example, the content property of <xref:Microsoft.Maui.Controls.Label> is `Text`. <!--For more information, see the [API documentation]().-->
+Many classes also have [`ContentProperty`](xref:Microsoft.Maui.Controls.ContentPropertyAttribute) attribute definitions. For example, the content property of <xref:Microsoft.Maui.Controls.Label> is `Text`. <!--For more information, see the [API documentation]().-->
 
 ## Platform differences
 
diff --git a/docs/xaml/markup-extensions/consume.md b/docs/xaml/markup-extensions/consume.md
@@ -101,7 +101,7 @@ Just as you can abbreviate `x:StaticExtension` to `x:Static` when you use it as
        FontSize="{x:Static Member=local:AppConstants.NormalFontSize}" />
 ```
 
-The <xref:Microsoft.Maui.Controls.Xaml.StaticExtension> class has a `ContentProperty` attribute referencing the property `Member`, which marks this property as the class's default content property. For XAML markup extensions expressed with curly braces, you can eliminate the `Member=` part of the expression:
+The <xref:Microsoft.Maui.Controls.Xaml.StaticExtension> class has a [`ContentProperty`](xref:Microsoft.Maui.Controls.ContentPropertyAttribute) attribute referencing the property `Member`, which marks this property as the class's default content property. For XAML markup extensions expressed with curly braces, you can eliminate the `Member=` part of the expression:
 
 ```xaml
 <Label Text="Label No. 5"
