Merge pull request #682 from MicrosoftDocs/main

Merge to Live
MicrosoftDocs · Feb 1, 2023 · 3a19494 · 3a19494
2 parents b06b414 + ab8afee
commit 3a19494
Show file tree

Hide file tree

Showing 35 changed files with 149 additions and 3,744 deletions.
diff --git a/.openpublishing.redirection.json b/.openpublishing.redirection.json
@@ -1,29 +1,112 @@
 {
     "redirections": [
       {
-        "source_path": "archive/graph/providers/InteractiveProviderBehavior.md",
-        "redirect_url": "/graph/providers/interactiveproviderbehavior",
-        "redirect_document_id": true
+        "source_path": "docs/archive/graph/providers/InteractiveProviderBehavior.md",
+        "redirect_url": "/graph/providers/interactiveproviderbehavior"
       },
       {
-        "source_path": "archive/graph/providers/MockProviderBehavior.md",
-        "redirect_url": "/graph/providers/mockproviderbehavior",
-        "redirect_document_id": true
+        "source_path": "docs/archive/graph/providers/MockProviderBehavior.md",
+        "redirect_url": "/graph/providers/mockproviderbehavior"
       },
       {
-        "source_path": "graph/authentication/msal.md",
-        "redirect_url": "/graph/authentication/msalprovider",
-        "redirect_document_id": true
+        "source_path": "docs/graph/authentication/msal.md",
+        "redirect_url": "/graph/authentication/msalprovider"
       },
       {
-        "source_path": "graph/authentication/windows.md",
-        "redirect_url": "/graph/authentication/windowsprovider",
-        "redirect_document_id": true
+        "source_path": "docs/graph/authentication/windows.md",
+        "redirect_url": "/graph/authentication/windowsprovider"
       },
       {
-        "source_path": "graph/authentication/custom.md",
-        "redirect_url": "/graph/authentication/iprovider",
-        "redirect_document_id": true
+        "source_path": "docs/graph/authentication/custom.md",
+        "redirect_url": "/graph/authentication/iprovider"
+      },
+      {
+        "source_path": "docs/mvvm/Introduction.md",
+        "redirect_url": "/dotnet/communitytoolkit/mvvm/"
+      },
+      {
+        "source_path": "docs/mvvm/ObservableObject.md",
+        "redirect_url": "/dotnet/communitytoolkit/mvvm/observableobject"
+      },
+      {
+        "source_path": "docs/mvvm/ObservableRecipient.md",
+        "redirect_url": "/dotnet/communitytoolkit/mvvm/observablerecipient"
+      },
+      {
+        "source_path": "docs/mvvm/ObservableValidator.md",
+        "redirect_url": "/dotnet/communitytoolkit/mvvm/observablevalidator"
+      },
+      {
+        "source_path": "docs/mvvm/RelayCommand.md",
+        "redirect_url": "/dotnet/communitytoolkit/mvvm/relaycommand"
+      },
+      {
+        "source_path": "docs/mvvm/AsyncRelayCommand.md",
+        "redirect_url": "/dotnet/communitytoolkit/mvvm/asyncrelaycommand"
+      },
+      {
+        "source_path": "docs/mvvm/Messenger.md",
+        "redirect_url": "/dotnet/communitytoolkit/mvvm/messenger"
+      },
+      {
+        "source_path": "docs/mvvm/Ioc.md",
+        "redirect_url": "/dotnet/communitytoolkit/mvvm/ioc"
+      },
+      {
+        "source_path": "docs/mvvm/PuttingThingsTogether.md",
+        "redirect_url": "/dotnet/communitytoolkit/mvvm/puttingthingstogether"
+      },
+      {
+        "source_path": "docs/mvvm/MigratingFromMvvmLight.md",
+        "redirect_url": "/dotnet/communitytoolkit/mvvm/migratingfrommvvmlight"
+      },
+      {
+        "source_path": "docs/mvvm/MigratingFromMvvmBasic.md",
+        "redirect_url": "/dotnet/communitytoolkit/mvvm/migratingfrommvvmbasic"
+      },
+      {
+        "source_path": "docs/high-performance/Introduction.md",
+        "redirect_url": "/dotnet/communitytoolkit/high-performance/introduction"
+      },
+      {
+        "source_path": "docs/high-performance/MemoryOwner.md",
+        "redirect_url": "/dotnet/communitytoolkit/high-performance/memoryowner"
+      },
+      {
+        "source_path": "docs/high-performance/SpanOwner.md",
+        "redirect_url": "/dotnet/communitytoolkit/high-performance/spanowner"
+      },
+      {
+        "source_path": "docs/high-performance/StringPool.md",
+        "redirect_url": "/dotnet/communitytoolkit/high-performance/stringpool"
+      },
+      {
+        "source_path": "docs/high-performance/Memory2D.md",
+        "redirect_url": "/dotnet/communitytoolkit/high-performance/memory2d"
+      },
+      {
+        "source_path": "docs/high-performance/Span2D.md",
+        "redirect_url": "/dotnet/communitytoolkit/high-performance/span2d"
+      },
+      {
+        "source_path": "docs/high-performance/ParallelHelper.md",
+        "redirect_url": "/dotnet/communitytoolkit/high-performance/parallelhelper"
+      },
+      {
+        "source_path": "docs/high-performance/Ref.md",
+        "redirect_url": "/dotnet/communitytoolkit/high-performance/ref"
+      },
+      {
+        "source_path": "docs/diagnostics/Introduction.md",
+        "redirect_url": "/dotnet/communitytoolkit/diagnostics/introduction"
+      },
+      {
+        "source_path": "docs/developer-tools/Guard.md",
+        "redirect_url": "/dotnet/communitytoolkit/diagnostics/guard"
+      },
+      {
+        "source_path": "docs/developer-tools/ThrowHelper.md",
+        "redirect_url": "/dotnet/communitytoolkit/diagnostics/throwhelper"
       }
     ]
 }
diff --git a/docs/Nuget-Packages.md b/docs/Nuget-Packages.md
@@ -5,25 +5,30 @@ description: The Windows Community Toolkit is updated regularly with new control
 keywords: windows 10, uwp, windows community toolkit, uwp community toolkit, uwp toolkit, nuget, visual studio
 ---
 
-# Windows Community Toolkit NuGet Packages
+# Community Toolkit NuGet Packages
 
 NuGet is a standard package manager for .Net applications that is built into Visual Studio. From your open solution choose the *Tools* menu, *NuGet Package Manager*, *Manage NuGet packages for solution...* to open the UI.  Enter one of the package names below to search for it online.
 
 | NuGet Package Name | Description |
 | --- | --- |
-| Microsoft.Toolkit | .NET Standard NuGet package containing common code |
-| Microsoft.Toolkit.HighPerformance | .NET Standard and .NET Core NuGet package with performance oriented helpers, extensions, etc. |
-| Microsoft.Toolkit.Parsers | .NET Standard NuGet package containing cross-platform parsers, such as Markdown and RSS |
-| Microsoft.Toolkit.Services | .NET Standard NuGet package containing cross-platform services |
-| Microsoft.Toolkit.Uwp | Main NuGet package includes code only helpers such as Colors conversion tool, Storage file handling, a Stream helper class, etc. |
-| Microsoft.Toolkit.Uwp.Notifications | Notifications Package - Generate tile, toast, and badge notifications for Windows 10 via code.  Includes intellisense support to avoid having to use the XML syntax |
-| Microsoft.Toolkit.Uwp.Notifications.Javascript | Notification Packages for JavaScript |
-| Microsoft.Toolkit.Uwp.Services | Services Package - This NuGet package includes the service helpers for Facebook, LinkedIn, Microsoft Graph, Twitter and more |
+| CommunityToolkit.Common | .NET Standard NuGet package containing common code |
+| CommunityToolkit.Diagnostics | .NET Standard code helpers |
+| CommunityToolkit.HighPerformance | .NET Standard and .NET Core NuGet package with performance oriented helpers, extensions, etc. |
+| CommunityToolkit.Mvvm | [MVVM Toolkit](/dotnet/communitytoolkit/mvvm/) a modern, fast, and modular MVVM library for .NET Standard, platform and runtime agnostic |
+| CommunityToolkit.Maui | [MAUI Community Toolkit](/dotnet/communitytoolkit/maui) for .NET MAUI |
+| CommunityToolkit.WinUI.* | [WindowsAppSDK](/windows/apps/windows-app-sdk)/[WinUI 3](/windows/apps/winui/winui3) versions of the toolkit packages below. |
+| Microsoft.Toolkit.Uwp | Includes code only helpers such as Colors conversion tool, Storage file handling, a Stream helper class, etc. |
 | Microsoft.Toolkit.Uwp.UI | UI Packages - XAML converters, Visual tree extensions, and other extensions and helpers for your XAML UI |
 | Microsoft.Toolkit.Uwp.UI.Animations | Animations and Composition behaviors such as Blur, Fade, Rotate, etc. |
-| Microsoft.Toolkit.Uwp.UI.Controls | XAML Controls such as RadialGauge, RangeSelector, etc. |
+| Microsoft.Toolkit.Uwp.UI.Behaviors | Extra behaviors built on top of the [XAML Behaviors](https://github.com/microsoft/XamlBehaviors/wiki) library. |
+| Microsoft.Toolkit.Uwp.UI.Controls | Wrapping package of all controls, for best disk footprint, use individual packages. |
+| Microsoft.Toolkit.Uwp.UI.Controls.Core | Common controls useful for a variety of applications. |
 | Microsoft.Toolkit.Uwp.UI.Controls.DataGrid | XAML DataGrid control |
-| Microsoft.Toolkit.Uwp.UI.Controls.Layout | XAML layout controls such as WrapLayout, StaggeredLayout, etc. |
+| Microsoft.Toolkit.Uwp.UI.Controls.Input | Controls related to retrieving information or values. |
+| Microsoft.Toolkit.Uwp.UI.Controls.Layout | Controls for various application layout scenarios. |
+| Microsoft.Toolkit.Uwp.UI.Controls.Markdown | Markdown renderer control. |
+| Microsoft.Toolkit.Uwp.UI.Controls.Media | Controls that depend on Win2D. |
+| Microsoft.Toolkit.Uwp.UI.Controls.Primitives | Panels and simple layout controls without stlyes |
 | Microsoft.Toolkit.Uwp.UI.Lottie | Library for rendering Adobe AfterEffects animations natively in Windows apps |
 | Microsoft.Toolkit.Uwp.UI.Media | Brushes, Win2D/Composition effects, and helpers to create visual effects  |
 | Microsoft.Toolkit.Uwp.Connectivity | API helpers such as BluetoothLEHelper and Networking |
@@ -37,7 +42,7 @@ Searching in Visual Studio package manager you should see a list similar to the
 
 ## Update NuGet Packages
 
-The Windows Community Toolkit is updated regularly with new controls, services, APIs, and more importantly, bug fixes. To make sure you are on the latest version, open your project in Visual Studio, choose the **Tools** menu, select **NuGet Package Manager** -> **Manage NuGet Packages for Solution...** and select the *Updates* tab. Select the package you want to update and click Instal to update to the latest version.
+The Windows Community Toolkit is updated regularly with new controls, services, APIs, and more importantly, bug fixes. To make sure you are on the latest version, open your project in Visual Studio, choose the **Tools** menu, select **NuGet Package Manager** -> **Manage NuGet Packages for Solution...** and select the *Updates* tab. Select the package you want to update and click Install to update to the latest version.
 
 ## Getting Started
 

diff --git a/docs/archive/graph/providers/InteractiveProviderBehavior.md b/docs/archive/graph/providers/InteractiveProviderBehavior.md
diff --git a/docs/archive/graph/providers/MockProviderBehavior.md b/docs/archive/graph/providers/MockProviderBehavior.md
diff --git a/docs/brushes/TilesBrush.md b/docs/brushes/TilesBrush.md
@@ -7,7 +7,7 @@ keywords: windows 10, uwp, windows community toolkit, uwp community toolkit, uwp
 
 # TilesBrush
 
-The [TilesBrush](/dotnet/api/microsoft.toolkit.uwp.ui.media.tilesbrush) is a [Brush](/uwp/api/windows.ui.xaml.media.brush) that that displays a tiled image.
+The [TilesBrush](/dotnet/api/microsoft.toolkit.uwp.ui.media.tilesbrush) is a [Brush](/uwp/api/windows.ui.xaml.media.brush) that displays a tiled image.
 
 > [!div class="nextstepaction"]
 > [Try it in the sample app](uwpct://Brushes?sample=TilesBrush)

diff --git a/docs/controls/HeaderedItemsControl.md b/docs/controls/HeaderedItemsControl.md
@@ -23,7 +23,7 @@ The [HeaderedItemsControl](/dotnet/api/microsoft.toolkit.uwp.ui.controls.headere
 
 <controls:HeaderedItemsControl>
     <!-- Header content or HeaderTemplate content -->
-</<controls:HeaderedItemsControl>
+</controls:HeaderedItemsControl>
 ```
 
 ## Sample Output
@@ -53,7 +53,7 @@ The [HeaderedItemsControl](/dotnet/api/microsoft.toolkit.uwp.ui.controls.headere
                 <TextBlock Text="This is the header!" FontSize="16">
             </Border>
         </controls:HeaderedItemsControl.Header>
-    </<controls:HeaderedItemsControl>
+    </controls:HeaderedItemsControl>
     ```
 
 - Used to control the look of the header. The default value for the `HeaderTemplate` will display the string representation of the `Header`. Set this property if you need to bind the `Header` to an object.
@@ -67,7 +67,7 @@ The [HeaderedItemsControl](/dotnet/api/microsoft.toolkit.uwp.ui.controls.headere
                 <TextBlock Text="{Binding Title}">
             </DataTemplate>
         </controls:HeaderedItemsControl.HeaderTemplate>
-    </<controls:HeaderedItemsControl>
+    </controls:HeaderedItemsControl>
     ```
 
 ## Sample Project

diff --git a/docs/controls/datagrid_guidance/styling_formatting_options.md b/docs/controls/datagrid_guidance/styling_formatting_options.md
@@ -66,8 +66,10 @@ All individual parts of the DataGrid control are customizable through simple Sty
 * *RowHeaderStyle* : style that is used when rendering the row headers. The DataGrid control does not have a default visual for the row header. To provide one you must provide a `ContentTemplate` for `Microsoft.Toolkit.Uwp.UI.Controls.Primitives.DataGridRowHeader`. For Example:
 
 ```xaml
-   xmlns:wctprimitives="using:Microsoft.Toolkit.Uwp.UI.Controls.Primitives"
+xmlns:wctprimitives="using:Microsoft.Toolkit.Uwp.UI.Controls.Primitives"
 
+// This will display the column headers as one cell with the heading text
+<controls:DataGrid.RowHeaderStyle>
    <Style TargetType="wctprimitives:DataGridRowHeader">
       <Setter Property="Template">
            <Setter.Value>
@@ -79,6 +81,24 @@ All individual parts of the DataGrid control are customizable through simple Sty
            </Setter.Value>
       </Setter>
    </Style>
+</controls:DataGrid.RowHeaderStyle>
+```
+
+OR
+
+```xaml
+// This will display the individual column headers if defined
+<controls:DataGrid.ColumnHeaderStyle>
+   <Style TargetType="wctprimitives:DataGridColumnHeader">
+      <Setter Property="Template">
+         <Setter.Value>
+            <ControlTemplate TargetType="wctprimitives:DataGridColumnHeader">
+               <ContentPresenter Background="Red" />
+            </ControlTemplate>
+         </Setter.Value>
+      </Setter>
+   </Style>
+</controls:DataGrid.ColumnHeaderStyle>
 ```
 
 Whether defined as an inline style or as a resource, the Style defines the appearance of cells/rows/columns/headers in the data grid, and should specify the appropriate TargetType (say, **DataGridCell** for CellStyle). You typically specify setters for individual properties, and might also use a setter for the Template property if you wanted to change the composition of elements.