You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: CONTRIBUTING.md
+20-23Lines changed: 20 additions & 23 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -14,21 +14,21 @@ Contributions from the community in the form of feature requests and bugs are ha
14
14
15
15
## New contributors
16
16
17
-
We mark the most straightforward issues with labels. These issues are the place to start if you are interested in contributing but new to the codebase.
17
+
We mark the most straightforward issues with labels. These issues are the place to start if you are interested in contributing, but new to the codebase.
18
18
19
-
*[good first issues](https://github.com/Microsoft/microsoft-ui-xaml/labels/good%20first%20issue)
-[Coding style and conventions](docs/code_style_and_conventions.md)
48
48
49
49
### Contributor License Agreement
50
50
51
-
Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.
51
+
Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit <https://cla.microsoft.com>.
52
52
53
53
When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.
54
54
55
55
### Copying files from other projects
56
56
57
57
The following rules must be followed for PRs that include files from another project:
58
58
59
-
* The license of the file is [permissive](https://en.wikipedia.org/wiki/Permissive_free_software_licence).
60
-
* The license of the file is left intact.
61
-
* The contribution is correctly attributed in the [3rd party notices](https://github.com/dotnet/coreclr/blob/master/THIRD-PARTY-NOTICES.TXT)
59
+
- The license of the file is [permissive](https://en.wikipedia.org/wiki/Permissive_free_software_licence).
60
+
- The license of the file is left intact.
61
+
- The contribution is correctly attributed in the [3rd party notices](https://github.com/dotnet/coreclr/blob/master/THIRD-PARTY-NOTICES.TXT)
62
62
file in the repository, as needed.
63
63
64
64
## Documentation and usage samples
65
65
66
-
You can also read and contribute to the WinUI documentation here:
67
-
https://docs.microsoft.com/uwp/toolkits/winui
66
+
You can also read and contribute to the WinUI documentation here: [WinUI documentation](https://learn.microsoft.com/uwp/toolkits/winui)
68
67
69
-
You can find usage examples of the controls available in WinUI in the WinUI 3 Gallery app:
70
-
https://github.com/Microsoft/WinUI-Gallery/
68
+
You can find usage examples of the controls available in WinUI in the WinUI 3 Gallery app: [WinUI 3 Gallery app](https://github.com/Microsoft/WinUI-Gallery/)
71
69
72
-
Which can also be installed from the Microsoft Store:
73
-
https://apps.microsoft.com/detail/9p3jfpwwdzrc
74
-
75
-
## API spec discussions
70
+
Which can also be installed from the Microsoft Store: [Microsoft Store](https://apps.microsoft.com/detail/9p3jfpwwdzrc)
76
71
77
-
Before new features are added to WinUI, we always perform a thorough API review and spec discussion. This can range from a single new API to an entire new control featuring dozens of new APIs. Joining such a spec discussion is a great opportunity for developers to help ensuring that new WinUI APIs will look and feel natural. In addition, spec discussions are the follow-up to feature proposals and will go into much finer details than the initial proposal. As such, taking part in these discussions gives developers the chance to be involved in the complete development process of new WinUI features - from their initial high-level inception right down to specific implementation/behavior details. These discussions take place in the WInUI repository, i.e. this repository.
72
+
## API spec discussions
73
+
74
+
Before new features are added to WinUI, we always perform a thorough API review and spec discussion. This can range from a single new API to an entire new control featuring dozens of new APIs. Joining such a spec discussion is a great opportunity for developers to help ensuring that new WinUI APIs will look and feel natural. In addition, spec discussions are the follow-up to feature proposals and will go into much finer details than the initial proposal. As such, taking part in these discussions gives developers the chance to be involved in the complete development process of new WinUI features - from their initial high-level inception right down to specific implementation/behavior details. These discussions take place in the WinUI repository, i.e. this repository.
Copy file name to clipboardExpand all lines: CONTRIBUTING_feedback_and_requests.md
+44-40Lines changed: 44 additions & 40 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,67 +6,71 @@ The guide below outlines how you can formulate this feedback for maximum effect
6
6
7
7
## Phrasing constructively
8
8
9
-
When experiencing a pain-point, it can be natural to focus on the negatives and resolving things from the perspective of the negative. However, telling the team what you'd like to *prevent* is less helpful and actionable than telling the team what you'd like to *achieve*.
9
+
When experiencing a pain-point, it can be natural to focus on the negatives and resolving things from the perspective of the negative. However, telling the team what you'd like to _prevent_ is less helpful and actionable than telling the team what you'd like to _achieve_.
10
10
11
-
Your feedback is most effective when it is a constructive call to action on the team, and is clear and detailed – especially on the "why" so that we can make sure whatever it is that we arrive at together appropriately focuses on your goal and your intended outcome from start to finish.
11
+
Your feedback is most effective when it is a constructive call to action on the team, and is clear and detailed – especially on the "why" so that we can make sure whatever it is that we arrive at together appropriately focuses on your goal and your intended outcome from start to finish.
12
12
13
-
14
-
**Examples of constructively phrased feedback:**
13
+
### Examples of constructively phrased feedback
15
14
16
15
Instead of:
17
16
18
-
- The state of the platform is disappointing. I am not going to consider WinUI until my trust has been earned.
17
+
- The state of the platform is disappointing. I am not going to consider WinUI until my trust has been earned.
19
18
20
19
Try this:
21
-
- Deprecation of past frameworks has left me burned. The following would go a long way in earning my trust because my company is trying to launch an app next year and will need it supported for at least 5 more:
22
-
- OSS
23
-
- High-confidence 5-year roadmap
24
-
- Guaranteed support timeline
25
-
26
-
This feedback provides clear actionable items that the WinUI team can take into consideration and address.
27
-
28
-
20
+
21
+
- Deprecation of past frameworks has left me burned. The following would go a long way in earning my trust because my company is trying to launch an app next year and will need it supported for at least 5 more:
22
+
- OSS
23
+
- High-confidence 5-year roadmap
24
+
- Guaranteed support timeline
25
+
26
+
This feedback provides clear actionable items that the WinUI team can take into consideration and address.
27
+
29
28
## Sample areas where your feedback can have large impact
30
29
31
-
-### Features
32
-
- It's very helpful to specify the "why" behind your request, even if it seems obvious. Comparisons can help, but shouldn't replace explanation.
33
-
- Ex: "I need `<`feature`>` so that I can achieve `<`goal`>`. Otherwise, I have to `<`alternative`>`."
30
+
### Features
31
+
32
+
- It's very helpful to specify the "why" behind your request, even if it seems obvious. Comparisons can help, but shouldn't replace explanation.
33
+
- Example: "I need \<feature\> so that I can achieve \<goal\>. Otherwise, I have to \<alternative\>."
34
+
35
+
There are also usually great opportunities to have feature-related impact in our [spec repo](https://github.com/microsoft/microsoft-ui-xaml-specs/tree/master). Here, you can give direct feedback and help shape the new features and APIs that we're currently building.
34
36
35
-
There are also usually great opportunities to have feature-related impact in our [spec repo](https://github.com/microsoft/microsoft-ui-xaml-specs/tree/master). Here, you can give direct feedback and help shape the new features and APIs that we're currently building.
37
+
### Future/Roadmap
36
38
37
-
-### Future/Roadmap
38
-
- We strive to be transparent about our [product roadmap](https://aka.ms/winui3/feature-roadmap). Great examples of feedback to help us achieve this are:
39
-
- "I'd like to know the roadmap through `<`timeframe`>`. Otherwise, I can't do `<`goal`>`. "
40
-
- "The roadmap `<`certain aspect - e.g., changes too much, not detailed enough, etc.`>`prevents me from being able to do `<`goal`>`. If you would instead `<`proposed alternative`>`, that would result in `<`clear benefit`>`."
39
+
- We strive to be transparent about our [product roadmap](https://aka.ms/winui3/feature-roadmap). Great examples of feedback to help us achieve this are:
40
+
- "I'd like to know the roadmap through \<timeframe\>. Otherwise, I can't do \<goal\>."
41
+
- "The roadmap \<certain aspect - e.g., changes too much, not detailed enough, etc.\> prevents me from being able to do \<goal\>. If you would instead \<proposed alternative\>, that would result in \<clear benefit\>."
41
42
42
-
-### Ecosystem
43
-
- It's helpful to be complete in explaining what another solution achieves for you and why it is important to you.
44
-
- Ex:"I'd like WinUI 3 to work with `<`framework, language, library, technology, etc.`>`. Without this, I can't do `<`goal`>`."
43
+
### Ecosystem
45
44
46
-
-### Prioritization within WinUI
47
-
- There is often trade-off required when adjusting priorities - please be clear in comparing what is more important vs. less important to you, and the reason why.
48
-
- Ex: "I think `<`specific area or feature set`>` should be prioritized before `<`other specific area or feature set`>` so that I can achieve `<`goal`>`. Without this, I have to `<`alternative`>`. "
45
+
- It's helpful to be complete in explaining what another solution achieves for you and why it is important to you.
46
+
- Example:"I'd like WinUI 3 to work with \<framework, language, library, technology, etc.\>. Without this, I can't do \<goal\>."
47
+
48
+
### Prioritization within WinUI
49
+
50
+
- There is often trade-off required when adjusting priorities - please be clear in comparing what is more important vs. less important to you, and the reason why.
51
+
- Example: "I think \<specific area or feature set\> should be prioritized before \<other specific area or feature set\> so that I can achieve \<goal\>. Without this, I have to \<alternative\>. "
52
+
53
+
### Engagement
54
+
55
+
- Engagement includes feedback about learning materials and resources. It is always helpful to know where you prefer to be engaged and how you prefer to learn.
56
+
- "I would like to hear more about \<specific topic\> in \<resource\> so that I can achieve \<goal\>."
57
+
- "\<Resource\> could be more inclusive and accessible if you considered \<alternative\> because \<benefit\>. Have you considered making these changes?"
49
58
50
-
-### Engagement
51
-
- Engagement includes feedback about learning materials and resources. It is always helpful to know where you prefer to be engaged and how you prefer to learn.
52
-
- "I would like to hear more about `<`specific topic`>` in `<`resource`>` so that I can achieve `<`goal`>`."
53
-
- "`<`Resource`>` could be more inclusive and accessible if you considered `<`alternative`>` because `<`benefit`>`. Have you considered making these changes?"
54
-
55
59
Many of the resources we provide are also open source themselves! It can sometimes be more effective to leave feedback on the more specific repo. This includes:
- Team process includes feedback about our repo and overall communication. Suggestions for improvement and proposed alternatives are very helpful here.
63
-
- Ex: "`<`specific aspect of team process - e.g., response frequency, format`>` of the repo is making it hard for me to achieve `<`goal`>`. Please consider doing `<`alternative`>` instead because that would help `<`action`>`"
- Team process includes feedback about our repo and overall communication. Suggestions for improvement and proposed alternatives are very helpful here.
68
+
- Example: "\<specific aspect of team process - e.g., response frequency, format\> of the repo is making it hard for me to achieve \<goal\>. Please consider doing \<alternative\> instead because that would help \<action\>."
65
69
66
70
## Mutual respect
67
71
68
72
We strive to be respectful & empathetic toward each other, and we extend this to our fantastic community as well.
69
73
70
74
Our conduct guidelines help to ensure that discourse and feedback follows this same pattern of respect & empathy, and they also make it clear that non-constructive or hostile feedback is unacceptable. By following these guidelines, we can all enjoy the mutual respect that each WinUI team member, and each community member, deserve.
71
75
72
-
Refer to our [conduct guidelines](https://github.com/microsoft/microsoft-ui-xaml/blob/main/CODE_OF_CONDUCT.md) for more guidance here.
76
+
Refer to our [conduct guidelines](https://github.com/microsoft/microsoft-ui-xaml/blob/main/CODE_OF_CONDUCT.md) for more guidance here.
Copy file name to clipboardExpand all lines: README.md
+10-8Lines changed: 10 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -31,22 +31,22 @@ WinUI is a user interface layer that contains modern controls and styles for bui
31
31
32
32
## 📋 Getting started with WinUI
33
33
34
-
For WinUI, your app's users must be on Windows 10 1809 - Build 17763 or newer (including Windows Insider Previews).
34
+
For WinUI, your app's users must be on Windows 10 1809 - build 17763 or newer (including Windows Insider Previews).
35
35
36
36
The full documentation of WinUI can be found on [Microsoft Learn](https://learn.microsoft.com/windows/apps/):
37
+
37
38
-[Get started with WinUI](https://learn.microsoft.com/windows/apps/get-started/start-here)
38
39
-[Build your first WinUI app](https://learn.microsoft.com/windows/apps/tutorials/winui-notes/)
39
40
-[Migrate from UWP to the Windows App SDK](https://learn.microsoft.com/windows/apps/windows-app-sdk/migrate-to-windows-app-sdk/migrate-to-windows-app-sdk-ovw)
40
41
-[Windows Runtime APIs not supported in desktop apps](https://learn.microsoft.com/windows/apps/desktop/modernize/desktop-to-uwp-supported-api)
41
42
-[WinUI & Windows App SDK samples](https://learn.microsoft.com/windows/apps/get-started/samples)
42
43
43
-
</br>
44
-
45
44
## 🖼️ WinUI 3 Gallery
45
+
46
46
Make sure to also check out the [WinUI 3 Gallery](https://aka.ms/winui-gallery), our interactive sample experience showing everything you can do with WinUI.
@@ -57,6 +57,7 @@ Make sure to also check out the [WinUI 3 Gallery](https://aka.ms/winui-gallery),
57
57
</p>
58
58
59
59
## 📺 WinUI Community Call
60
+
60
61
The WinUI Community Call is your opportunity to learn about WinUI and to engage with the WinUI team and community. Join us online on YouTube at the [Windows Developer channel](https://www.youtube.com/playlist?list=PLI_J2v67C23ZqsolUDaHoFkF1GKvGrttB).
61
62
62
63
## 📢 Contributing to WinUI
@@ -73,16 +74,17 @@ For information on how to contribute, please see [Contributing to WinUI](CONTRIB
73
74
> [WinUI OSS Update post](https://github.com/microsoft/microsoft-ui-xaml/discussions/10700) to check the
74
75
> latest status.
75
76
>
76
-
> For the latest code and updates, use the [`winui3/main`](https://github.com/microsoft/microsoft-ui-xaml/tree/winui3/main) branch.
77
+
> For the latest code and updates, use the [winui3/main](https://github.com/microsoft/microsoft-ui-xaml/tree/winui3/main) branch.
77
78
78
79
## 🛣️ Roadmap
79
80
80
-
For info on the WinUI release schedule and high level plans please see the [WinUI roadmap](https://aka.ms/winappsdk/plans).
81
+
For info about the WinUI release schedule and high level plans please see the [WinUI roadmap](https://aka.ms/winappsdk/plans).
81
82
82
83
## 🔧 WinUI for UWP
83
-
WinUI for UWP (WinUI 2) is a library of controls that provides Microsoft UI controls and features for [UWP apps](https://docs.microsoft.com/windows/uwp/index). Learn more about WinUI for UWP [here](https://aka.ms/winui2) or download the source code [here](https://github.com/microsoft/microsoft-ui-xaml/tree/winui2/main).
84
84
85
-
You can get the WinUI 2 Gallery [on the Microsoft Store](https://www.microsoft.com/store/productId/9MSVH128X2ZT?ocid=pdpshare) and see the source code [here](https://github.com/microsoft/WinUI-Gallery/tree/winui2).
85
+
WinUI for UWP (WinUI 2) is a library of controls that provides Microsoft UI controls and features for [UWP apps](https://learn.microsoft.com/windows/uwp/index). Learn more about WinUI for UWP [on MS Learn](https://aka.ms/winui2) or download the source code [on GitHub](https://github.com/microsoft/microsoft-ui-xaml/tree/winui2/main).
86
+
87
+
You can get the WinUI 2 Gallery [in the Microsoft Store](https://www.microsoft.com/store/productId/9MSVH128X2ZT?ocid=pdpshare) and see the source code [on GitHub](https://github.com/microsoft/WinUI-Gallery/tree/winui2).
0 commit comments