[Current] 6.1 Release Plan

[michael-hawker]

6.1 Release Plan

Incremental release focused on some new features along with bug-fixes and improvements.

Feature Freeze: 5/14/2020
Code Freeze: 5/21/2020 5/29/2020
Ship Date: 5/28/2020 6/4/2020

6.1-Preview1.2 on NuGet!

Work board Links

Note: there are an abundance of items currently earmarked for this release, the goal on our stream Thursday, April 2nd is to prune and clean-up this release for something achievable in the next 4-6 weeks.

• 6.1 Milestone Items.
• 6.1 Feature Tracking Board
• 6.1 Bug Tracking Board

The plan

 
Below is a summary of the top level plan items currently committed or completed. For a complete list of open bugs for this release, please see the tracking boards above instead.
 
Legend of annotations:

Symbol	Description
✋	needs assistance
0️⃣	priority 0 - must have for this release
1️⃣	priority 1 - nice to have for this release
2️⃣	priority 2 - stretch goal - unlikely for this release but we will try our best
❕	missing issue reference
🔦	investigating

New Controls/Features

• 0️⃣ Ship TokenizingTextBox control New control: AutoSuggestBox that allows snapping of resolved items #195, PeoplePicker down button adds a person #3027 (slipped from 6.0 due to TokenizingTextBox cannot be modified programatically #3057)
• 0️⃣ Toast Notification Helpers .NET Core 3 Support ToastNotifications for WPF (.NET Core 3) #3212
• 1️⃣ New ItemsRepeater Layouts [Feature] StaggeredLayout based on ItemsRepeater #3114 [Feature] Make WrapPanel be virtualized #3107 (In PR: Add new WrapLayout and StaggeredLayout controls #3160)
• 1️⃣ 🔦 ❕ Graph Control Improvements for updated Preview
• 1️⃣ .NET HighPerformance APIs (PR New Microsoft.Toolkit.HighPerformance package #3128 by @Sergio0694)
• 1️⃣ Observable Grouping API (PR Add observable group API #3201 by @vgromfeld)
• 1️⃣ XAML Pipeline Brushes [Feature] Integration with UICompositionAnimations #3108 (PR Win2D pipeline brushes #3112 by @Sergio0694)
• 1️⃣ Add Command to ListViewExtensions Unknown attachable member 'ListViewExtensions.Command' on element 'ListView' #3078 (In PR Making the ListExtensions feature in-line with the documentation #3209 by @deanchalk)
• ✋ 2️⃣ AdvancedCollectionView Improvements AdvancedCollectionView part deux #1128 ✋
• ✋ 2️⃣ RotatorTile OnCurrentItemChanging Event [Feature]RotatorTile OnCurrentItemChanging #2994 ✋
• ✋ 2️⃣ Gaze Input Cursor Color [Feature] Add GazeInput.SetCursorBrush method to change the default GazeCursor color #3210 ✋
• 2️⃣ 🔦 Create XAML based DropShadow API helper [Feature] Shadow Receiver XAML Helpers #3122
• .NET Guard APIs (PR Guard APIs #3131 by @Sergio0694)
• UIElement.ClipToBounds [Feature] Integration with UICompositionAnimations #3108 (PR UIElement.ClipToBounds property #3111 & UIElement.ClipToBounds property  #3193 by @Sergio0694 and @vgromfeld)
• BaseObjectStorageHelper customizable serialization [Feature] Allow providing a custom JsonSerializer to BaseObjectStorageHelper #3175 (PR Let BaseObjectStorageHelper use custom JsonSerializerOptions #3181 by @simop-msft)

Bug Fixes/Improvements

• 0️⃣ Update XAML Behaviors package dependency See Update XAML Behaviors Dependency #3008
• Fixed InfiniteCanvas Italics Re-selecting an InfiniteCanvas text node can show incorrect Italics state in certain situations #3118 (PR Fix "Italic" checkstate bug + fix "italic" typo in InfiniteCanvas control #3117 by @BurkusCat)
• Improve DataGrid Horizontal Scrolling Improve Horizontal Scrolling #3170 (PR Allow horizontal scrolling if the horizontal scrollbar is not disabled and the vertical scrollbar is disabled #3174 by @skendrot)
• Add missing ICommand.CanExecute to HyperlinkExtensions Hyperlink command extension is always executing the attached command #3171 (PR Add missing call to ICommand.CanExecute() in HyperlinkExtensions #3172 by @vgromfeld)
• RadialGauge default template value formatting (PR Fix RadialGauge default template value formatting #3153 by @jeromelaban)
• FileCache NullReferenceException FileCache GetFromCacheAsync throws NullReferenceException #3104 (PR FileCache throws NullReferenceException #3105 by @SoundersFan)
• Add missing TemplateParts to InfiniteCanvas (PR Add TemplateParts to InfiniteCanvas and consts #3188 by @michael-hawker)
• MarkdownTextBlock hyperlinks don't work after unload (PR [Bug fix] Fixed a bug where MarkdownTextBlock loses all events after … #3180 by @Jasonstein)
• Fixed InfiniteCanvas button theming issue Oddness with Theming and Selection in InfiniteCanvas Control? #3185 (PR #3185 - Oddness with Theming and Selection in InfiniteCanvas Control #3194 by @deanchalk)

Deprecation

• 0️⃣ TabView (see WinUI Parity work here)
• 0️⃣ RadialGradientBrush (see work on RadialGradientBrush done in WinUI here) - TODO: Finalize with WinUI planning
• Singleton Pattern Helper The Singleton<T> class should be removed #3134
• Facebook Service (underlying library is no longer supported)
• 🔦 AdaptiveGridView (can do a lot of this with ItemsRepeater, so need to write samples, are we sufficient in covering this?) (maybe we do this in 7.0?)

Stabilization

• ✋ 1️⃣ 🔦 Add Mocking for Unit Tests [Tests] Investigate how we can use Moq (or similar) in Unit Tests to fake WinRT APIs #3196 ✋
• 0️⃣ Unit Tests Pass Unit Tests does not run with latest Master #2133 & Run as part of CI (Enabled tests on build process. #3165, ✔ Fix Unit Tests for Integration with CI Builds 🎉🎉🎉 #3207 by @azchohfi & @michael-hawker)
• Clean-up IDE0059 Warnings (PR Remove IDE0059: Value assigned to variable is never used #3155 by @vgromfeld)
• Replace Task.FromResult by Task.CompletedTask (PR Replace Task.FromResult by Task.CompletedTask #3162 by @vgromfeld)
• Fix VS 2019 builds Need to do an msbuild restore in order to be able to build the WindowsCommunityToolkit solution #3012 (PR Fixes #3012 working around NuGet/Home#8388 #3084 by @michael-hawker)
• StyleCop Update Old StyleCop version #3187 (PR Updated StyleCop to 1.1.118. #3189 by @azchohfi)
• Sample app crash from InAppNotification (PR Sample app crash on InAppNotification control #2959 by @jp-weber)

[Sergio0694]

Leaving some more info/feedback here as requested on Twitter 😄

With respect to my own PRs:

• If possible, it'd be nice to have these new Guard APIs be included in 6.1 as well. It's just a couple of APIs I missed in the initial PR, plus the .NET Standard 2.1 target with some attributes. All tests passing, the PR is ready for review and up do date with master.
• Once the HighPerformance package is merged, I plan to make those two additional PRs I mentioned. One is just with a couple new APIs (those lookup indexers I mentioned a while back), the other adding multi-targeting to .NET Core 2.1/3.1 and UWP, and some refactoring. It'd be nice to have both merged in for 6.1, especially because the one with multi-targeting will help avoid issues for users using the package on runtimes like Mono.
• The FontIcon extensions should be ready for review and good to go now, only missing the documentation, which I'm going to write right now and submit a PR for.

Hope this helps, looking forward to the stream! 😊🚀

EDIT: side note, should we use 6.1 to also mark the RadialGradientBrush as Obsolete since it's now available out of the box in WinUI 2.4? Just to point new users towards that one instead 🤔

EDIT 2: opened a docs PR for the FontIconExtension(s), ready for review now 👍

[azchohfi]

#3205/#3206 is for 7.0.0. It definitely is a breaking change.