Skip to content

Commit

Permalink
Merge branch 'MicrosoftDocs:docs' into policyUpdates-0830
Browse files Browse the repository at this point in the history
  • Loading branch information
htcfreek authored Jul 6, 2024
2 parents 19f666b + 2a5fbf8 commit 003ccf2
Show file tree
Hide file tree
Showing 64 changed files with 546 additions and 78 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -163,7 +163,7 @@ Roaming data for an app is available in the cloud as long as it is accessed by t
> See important note about [roaming data](#roaming-data).
- Use roaming for user preferences and customizations, links, and small data files. For example, use roaming to preserve a user's background color preference across all devices.
- Use roaming to let users continue a task across devices. For example, roam app data like the contents of an drafted email or the most recently viewed page in a reader app.
- Use roaming to let users continue a task across devices. For example, roam app data like the contents of a drafted email or the most recently viewed page in a reader app.
- Handle the [**DataChanged**](/uwp/api/windows.storage.applicationdata.datachanged) event by updating app data. This event occurs when app data has just finished syncing from the cloud.
- Roam references to content rather than raw data. For example, roam a URL rather than the content of an online article.
- For important, time critical settings, use the *HighPriority* setting associated with [**RoamingSettings**](/uwp/api/windows.storage.applicationdata.roamingsettings).
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ Because teaching tip is transient, it would not be the recommended control for p
## Recommendations

* Tips are impermanent and should not contain information or options that are critical to the experience of an application.
* Try to avoid showing teaching tips too often. Teaching tips are most likely to each recieve individual attention when they are staggered throughout long sessions or across multiple sessions.
* Try to avoid showing teaching tips too often. Teaching tips are most likely to each receive individual attention when they are staggered throughout long sessions or across multiple sessions.
* Keep tips succinct and their topic clear. Research shows users, on average, only read 3-5 words and only comprehend 2-3 words before deciding whether to interact with a tip.
* Gamepad accessibility of a teaching tip is not guaranteed. For applications that predict gamepad input, please see [gamepad and remote control interactions]( ../../input/gamepad-and-remote-interactions.md#xy-focus-navigation-and-interaction). It is encouraged to test gamepad accessibility of each teaching tip using all possible configurations of an app's UI.
* When enabling a teaching tip to escape the xaml root, it is encouraged to also enable the IsLightDismissEnabled property and set the PreferredPlacement mode nearest to the center of the xaml root.
Expand Down
4 changes: 2 additions & 2 deletions hub/apps/design/controls/item-templates-gridview.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ This section contains item templates that you can use with a [**GridView**](/win
To demonstrate data binding, these templates bind **GridViewItems** to the example Recording class from the [data binding overview](/windows/uwp/data-binding/data-binding-quickstart).

> [!NOTE]
> Currently, when a **DataTemplate** contains multiple controls (for example, more than a single **TextBlock**), the default accessible name for screenreaders comes from .ToString() on the item. As a convenience you can instead set the [**AutomationProperties.Name**](/uwp/api/windows.ui.xaml.automation.automationproperties) on the root element of the **DataTemplate**. For more on accessibility, see [Accessibililty overview](../accessibility/accessibility-overview.md).
> Currently, when a **DataTemplate** contains multiple controls (for example, more than a single **TextBlock**), the default accessible name for screenreaders comes from .ToString() on the item. As a convenience you can instead set the [**AutomationProperties.Name**](/uwp/api/windows.ui.xaml.automation.automationproperties) on the root element of the **DataTemplate**. For more on accessibility, see [Accessibility overview](../accessibility/accessibility-overview.md).
## Icon and text
Use these templates to display a collection of apps in a grid with an icon and text.
Expand Down Expand Up @@ -152,6 +152,6 @@ Use this template to display a media collection with text overlay.
## Related articles
- [GridView class](/windows/windows-app-sdk/api/winrt/microsoft.UI.Xaml.Controls.GridView)
- [Data binding overview](/windows/uwp/data-binding/data-binding-quickstart)
- [Accessibililty overview](../accessibility/accessibility-overview.md)
- [Accessibility overview](../accessibility/accessibility-overview.md)
- [ListView and GridView sample](https://github.com/Microsoft/Windows-universal-samples/tree/master/Samples/XamlListView)
- [Thumbnail images](/windows/uwp/files/thumbnails)
4 changes: 2 additions & 2 deletions hub/apps/design/controls/item-templates-listview.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ This section contains item templates that you can use with a [**ListView**](/win
To demonstrate data binding, these templates bind **ListViewItems** to the example Recording class from the [data binding overview](/windows/uwp/data-binding/data-binding-quickstart).

> [!NOTE]
> Currently, when a **DataTemplate** contains multiple controls (for example, more than a single **TextBlock**), the default accessible name for screenreaders comes from .ToString() on the item. As a convenience you can instead set the [**AutomationProperties.Name**](/uwp/api/windows.ui.xaml.automation.automationproperties) on the root element of the **DataTemplate**. For more on accessibility, see [Accessibililty overview](../accessibility/accessibility-overview.md).
> Currently, when a **DataTemplate** contains multiple controls (for example, more than a single **TextBlock**), the default accessible name for screenreaders comes from .ToString() on the item. As a convenience you can instead set the [**AutomationProperties.Name**](/uwp/api/windows.ui.xaml.automation.automationproperties) on the root element of the **DataTemplate**. For more on accessibility, see [Accessibility overview](../accessibility/accessibility-overview.md).
## Single line list item
Use this template to display a list of items with an image and a single line of text.
Expand Down Expand Up @@ -125,6 +125,6 @@ Use this template to display a list of items with text in defined columns.
## Related articles
- [ListView class](/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.controls.listview)
- [Data binding overview](/windows/uwp/data-binding/data-binding-quickstart)
- [Accessibililty overview](../accessibility/accessibility-overview.md)
- [Accessibility overview](../accessibility/accessibility-overview.md)
- [ListView and GridView sample](https://github.com/Microsoft/Windows-universal-samples/tree/master/Samples/XamlListView)
- [Thumbnail images](/windows/uwp/files/thumbnails)
2 changes: 1 addition & 1 deletion hub/apps/design/input/guidelines-for-visualfeedback.md
Original file line number Diff line number Diff line change
Expand Up @@ -89,7 +89,7 @@ The thickness, margin, or whether or not the app-developer wishes to have the fo

### Color Properties

There are only two color properties for the focus visuals: the primary border color, and the secondary border color. These focus visual border colors can be changed per-control on an page level, and globally on an app-wide level:
There are only two color properties for the focus visuals: the primary border color, and the secondary border color. These focus visual border colors can be changed per-control on a page level, and globally on an app-wide level:

To brand focus visuals app-wide, override the system brushes:
```XAML
Expand Down
2 changes: 1 addition & 1 deletion hub/apps/design/motion/directionality-and-gravity.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,7 @@ Directional signals help to solidify the mental model of the journey a user take
:::row:::
:::column:::
Direction of movement corresponds to physical motion. Just like in nature, objects can move in any world axis - X,Y,Z. This is how we think of the movement of objects on the screen.
When you move objects, avoid unnatural collisions. ​Keep in mind where objects come from and go to, and alway support higher level constructs that may be used in the scene, such as scroll direction or layout hierarchy.​
When you move objects, avoid unnatural collisions. ​Keep in mind where objects come from and go to, and always support higher level constructs that may be used in the scene, such as scroll direction or layout hierarchy.​
:::column-end:::
:::column:::
![Short video showing a circle and then the addition of an X axis, a Y axis, and a Z axis.](images/direction.gif)
Expand Down
2 changes: 1 addition & 1 deletion hub/apps/design/style/iconography/app-icon-construction.md
Original file line number Diff line number Diff line change
Expand Up @@ -183,7 +183,7 @@ Windows 10 supports four tile sizes: small, medium, wide, and large.
* LargeTile.scale-125_altform-colorful_theme-light.png
* LargeTile.scale-150_altform-colorful_theme-light.png
* LargeTile.scale-200_altform-colorful_theme-light.png
8 LargeTile.scale-400_altform-colorful_theme-light.png
* LargeTile.scale-400_altform-colorful_theme-light.png

> [!NOTE]
> Windows 11 does not use the tile assets, but currently at minimum the Medium tile assets at 100% are required to publish to the Microsoft Store. If your app is Windows 10 & 11 compatible it is suggested that you include as many tile assets as possible.
Expand Down
2 changes: 1 addition & 1 deletion hub/apps/desktop/modernize/modernize-wpf-tutorial-4.md
Original file line number Diff line number Diff line change
Expand Up @@ -387,7 +387,7 @@ To add a notification to the app:
}
```

Toast notifications are represented by an XML payload, which can include text, images, actions, and more. You can find all the supported elements [here](/windows/uwp/design/shell/tiles-and-notifications/toast-schema). This code uses a very simple schema with two lines of text: the title and the body. After the code defines the XML payload and loads it in a **XmlDocument** object, it wraps the XML in a **ToastNotification** object and shows it by using the **ToastNotificationManager** class.
Toast notifications are represented by an XML payload, which can include text, images, actions, and more. You can find all the supported elements [here](/windows/uwp/design/shell/tiles-and-notifications/toast-schema). This code uses a very simple schema with two lines of text: the title and the body. After the code defines the XML payload and loads it in an **XmlDocument** object, it wraps the XML in a **ToastNotification** object and shows it by using the **ToastNotificationManager** class.

5. In the **ContosoExpenses.Core** project, expand the **ViewModels** folder and open the **AddNewExpenseViewModel.cs** file.

Expand Down
2 changes: 1 addition & 1 deletion hub/apps/desktop/modernize/modernize-wpf-tutorial.md
Original file line number Diff line number Diff line change
Expand Up @@ -85,7 +85,7 @@ The following sections provide background for some of the key concepts discussed

In Windows 8, Microsoft introduced a new API set as part of the Windows Runtime (WinRT). Unlike the .NET Framework, WinRT is a native layer of APIs which are exposed directly to apps. WinRT also introduced language projections, which are layers added on top of the runtime to allow developers to interact with it using languages such as C# and JavaScript in addition to C++. Projections enable developers to build apps on top of WinRT that leverage the same C# and XAML knowledge they acquired in building apps with the .NET Framework.

In Windows 10, Microsoft introduced the [Universal Windows Platform (UWP)](/windows/uwp/get-started/universal-application-platform-guide), which is built on top of WinRT. The most important feature of UWP is that it offers a common set of APIs across every device platform: no matter if the app is running on a desktop, on a Xbox One or on a HoloLens, you’re able to use the same APIs.
In Windows 10, Microsoft introduced the [Universal Windows Platform (UWP)](/windows/uwp/get-started/universal-application-platform-guide), which is built on top of WinRT. The most important feature of UWP is that it offers a common set of APIs across every device platform: no matter if the app is running on a desktop, on an Xbox One or on a HoloLens, you’re able to use the same APIs.

Going forward, most new Windows features are exposed via WinRT APIs, including features such as Timeline, Project Rome, and Windows Hello.

Expand Down
4 changes: 4 additions & 0 deletions hub/apps/develop/feeds/implement-feed-provider-cs.md
Original file line number Diff line number Diff line change
Expand Up @@ -451,3 +451,7 @@ To convert the console app created in this walkthrough to a Windows app, right-c

After you have developed and tested your feed provider you can publish your app on the Microsoft Store in order for users to install your feeds on their devices. For step by step guidance for publishing an app, see [Publish your app in the Microsoft Store](/windows/apps/publish/publish-your-app/overview?pivots=store-installer-msix).

### The Feeds Store Collection

After your app has been published on the Microsoft Store, you can request for your app to be included in the feeds Store Collection that helps users discover apps that feature Windows feeds. To submit your request, see [Submit your Feed/Board for addition to the Store Collection](https://forms.office.com/Pages/ResponsePage.aspx?id=v4j5cvGGr0GRqy180BHbR33MBPKauFRGiaSf7B00-UBUMk9FU1M0TEVOTjA4R0xGQTQwNU1aTFVQNi4u).

3 changes: 3 additions & 0 deletions hub/apps/develop/feeds/implement-feed-provider-win32.md
Original file line number Diff line number Diff line change
Expand Up @@ -466,3 +466,6 @@ To convert the console app created in this walkthrough to a Windows app:

After you have developed and tested your feed provider you can publish your app on the Microsoft Store in order for users to install your feeds on their devices. For step by step guidance for publishing an app, see [Publish your app in the Microsoft Store](/windows/apps/publish/publish-your-app/overview?pivots=store-installer-msix).

### The Feeds Store Collection

After your app has been published on the Microsoft Store, you can request for your app to be included in the feeds Store Collection that helps users discover apps that feature Windows feeds. To submit your request, see [Submit your Feed/Board for addition to the Store Collection](https://forms.office.com/Pages/ResponsePage.aspx?id=v4j5cvGGr0GRqy180BHbR33MBPKauFRGiaSf7B00-UBUMk9FU1M0TEVOTjA4R0xGQTQwNU1aTFVQNi4u).
2 changes: 1 addition & 1 deletion hub/apps/develop/win2d/offscreen-drawing.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ GaussianBlurEffect blurEffect = new GaussianBlurEffect()
};
```

An app can close, and re-open drawing sessions on a `CanvasRenderTarget` abitrarily many times.
An app can close, and re-open drawing sessions on a `CanvasRenderTarget` arbitrarily many times.

Drawing operations are not committed to the `CanvasRenderTarget` until the drawing session object is disposed. In C#, a `using` block can organize this.

Expand Down
2 changes: 1 addition & 1 deletion hub/apps/index.yml
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,7 @@ productDirectory:
- url: ./get-started/start-here.md
text: Get started with WinUI
- url: ./windows-app-sdk/support.md
text: Windows App SDK and suppported Windows releases
text: Windows App SDK and supported Windows releases
- url: ./windows-app-sdk/set-up-your-development-environment.md
text: Install tools for the Windows App SDK
- url: ./get-started/samples.md
Expand Down
27 changes: 14 additions & 13 deletions hub/apps/publish/store-policies.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: Microsoft Store Policies
description: Products on the Store must meet our certification standards, offer customers a truly useful and engaging experience, and provide a good fit for the Store.
ms.date: 01/16/2024
ms.date: 07/2/2024
ms.topic: article
keywords: store policies agreement
ms.localizationpriority: high
Expand Down Expand Up @@ -584,18 +584,19 @@ All products should adhere to the Microsoft Store Policies listed above. If your

### Microsoft Store complaint and appeal statistics

Numbers reported on 8/1/2023 (from 7/1/2022 through 6/30/2023)

| Statistic | Count |
|----------------------------------------------|----------|
| App and/or Account Enforcement Action Appeals | 1,616 |
| Complaints about Technological Issues | 54 |
| Regulatory Compliance Complaints | 0 |
| Questions about certification, policy, submission, and technical help | 1,772 |
| Miscellaneous | 357 |
| Total Issues | 4,212 |
| Overturned decisions | 842 |
| Average Processing Time | 5.95 days |
Numbers reported on umbers reported on 7/2/2024 (from 7/1/2023 – 6/30/2024)


| Statistic (FY2024) | Count |
|--------------------|----------|
| App and/or Account Enforcement Action Appeals | 829 |
| Complaints about Technological Issues | 36 |
| Regulatory Compliance Complaints | 0 |
| Questions about certification, policy, submission, and technical help | 2,554 |
| Miscellaneous | 663 |
| Total Issues | 4,542 |
| Overturned decisions | 587 |
| Average Processing Time | 2.10 days |


### See also
Expand Down
2 changes: 2 additions & 0 deletions hub/apps/toc.yml
Original file line number Diff line number Diff line change
Expand Up @@ -677,6 +677,8 @@ items:
href: windows-app-sdk/release-notes-archive/preview-channel-1.0.md
- name: Experimental channel release notes
items:
- name: Windows App SDK 1.5
href: windows-app-sdk/release-notes-archive/experimental-channel-1.5.md
- name: Windows App SDK 1.4
href: windows-app-sdk/release-notes-archive/experimental-channel-1.4.md
- name: Windows App SDK 1.3
Expand Down
2 changes: 1 addition & 1 deletion hub/apps/windows-app-sdk/check-windows-app-sdk-versions.md
Original file line number Diff line number Diff line change
Expand Up @@ -148,7 +148,7 @@ Status : Ok

## Related topics

- [Windows App SDK and suppported Windows releases](support.md)
- [Windows App SDK and supported Windows releases](support.md)
- [Runtime architecture](deployment-architecture.md)
- [Windows App SDK deployment guide for framework-dependent apps packaged with external location or unpackaged](deploy-unpackaged-apps.md)
- [Windows App SDK deployment guide for framework-dependent packaged apps](deploy-packaged-apps.md)
Expand Down
1 change: 1 addition & 0 deletions hub/apps/windows-app-sdk/downloads.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,6 +42,7 @@ For all the latest Windows App SDK downloads, refer to the tables and links belo

| Version | Runtime downloads |
|---|---|
| [1.6 Experimental2 (1.6.240701003-experimental2) ](/windows/apps/windows-app-sdk/experimental-channel#version-16-experimental-160-experimental2) <br/> 07/02/2024 <br/> [Release notes](/windows/apps/windows-app-sdk/experimental-channel#version-16-experimental-160-experimental2) <br/> [Source](https://github.com/microsoft/microsoft-ui-xaml/releases/tag/winui3%2Frelease%2F1.6-experimental2) | [Installer (x64)](https://aka.ms/windowsappsdk/1.6/1.6.240701003-experimental2/windowsappruntimeinstall-x64.exe) <br/> [Installer (x86)](https://aka.ms/windowsappsdk/1.6/1.6.240701003-experimental2/windowsappruntimeinstall-x86.exe) <br/> [Installer (arm64)](https://aka.ms/windowsappsdk/1.6/1.6.240701003-experimental2/windowsappruntimeinstall-arm64.exe) <br/> [Redistributable](https://aka.ms/windowsappsdk/1.6/1.6.240701003-experimental2/Microsoft.WindowsAppRuntime.Redist.1.6.zip) |
| [1.6 Experimental1 (1.6.240531000-experimental1) ](/windows/apps/windows-app-sdk/experimental-channel#version-16-experimental-160-experimental1) <br/> 06/04/2024 <br/> [Release notes](/windows/apps/windows-app-sdk/experimental-channel#version-16-experimental-160-experimental1) <br/> [Source](https://github.com/microsoft/microsoft-ui-xaml/releases/tag/winui3%2Frelease%2F1.6-experimental1) | [Installer (x64)](https://aka.ms/windowsappsdk/1.6/1.6.240531000-experimental1/windowsappruntimeinstall-x64.exe) <br/> [Installer (x86)](https://aka.ms/windowsappsdk/1.6/1.6.240531000-experimental1/windowsappruntimeinstall-x86.exe) <br/> [Installer (arm64)](https://aka.ms/windowsappsdk/1.6/1.6.240531000-experimental1/windowsappruntimeinstall-arm64.exe) <br/> [Redistributable](https://aka.ms/windowsappsdk/1.6/1.6.240531000-experimental1/Microsoft.WindowsAppRuntime.Redist.1.6.zip) |

Depending on your development scenario, you might require the following:
Expand Down
Loading

0 comments on commit 003ccf2

Please sign in to comment.