Check description of CommandBar please

[Jay-o-Way]

Issue type

enhancement

Which version of the app?

WinUI 3 Gallery

Description

App says

[...] When you need an app bar that contains only AppBarButton,AppBarToggleButton , and AppBarSeparator controls, use a CommandBar. If you need more complex content, such as images, progress bars, or text blocks, use an AppBar control."

MS Learn says

[!IMPORTANT] You should use the AppBar only when you are upgrading a Universal Windows 8 app that uses the AppBar, and need to minimize changes. For new apps in Windows 10, we recommend using the CommandBar control instead.

https://learn.microsoft.com/uwp/api/windows.ui.xaml.controls.appbar?view=winrt-22621

[Jay-o-Way]

Also, what's with "primary on the right and secondary on the left" ?

[karkarl]

@jwmsft Are you able to weigh in?

[jwmsft]

@Jay-o-Way, thanks for letting us know about this issue. It looks like CommandBar still has the description from the original Windows 8 version of the control, and it wasn't updated for the design and behavior changes that happened in Windows 10. (If you're wondering how the app ever got the Windows 8 descriptions in the first place, the WinUI Gallery is an evolution of a sample that was originally written for the Windows 8 docs.)

@karkarl, the description should be updated to reflect the current documentation.