Skip to content

Commit a9713df

Browse files
authored
Contributing guide: Add information about WinUI's API spec discussions (#3312)
* Contributing guide: Add information about WinUI's spec discussions * Improve wording. * Make github link language agnostic * CR feedback
1 parent 44767d1 commit a9713df

File tree

1 file changed

+7
-1
lines changed

1 file changed

+7
-1
lines changed

CONTRIBUTING.md

+7-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Contributing to the Windows UI Library
22

3-
We welcome your input and contributions to all aspects of WinUI, including bug reports, doc updates, feature proposals, and code contributions.
3+
We welcome your input and contributions to all aspects of WinUI, including bug reports, doc updates, feature proposals, code contributions and API spec discussions.
44

55
This document contains general guidance. More specific guidance is included in the documents linked below.
66

@@ -73,3 +73,9 @@ You can find usage examples of the controls available in WinUI in the Xaml Contr
7373

7474
which can also be installed from the Windows Store:
7575
https://www.microsoft.com/p/xaml-controls-gallery/9msvh128x2zt
76+
77+
## API spec discussions
78+
79+
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.
80+
81+
These discussions take place in this [repository](https://github.com/microsoft/microsoft-ui-xaml-specs). While API specs for feature proposals will typically be linked to in the specific proposal on the WinUI repository, not all active API specs will immediately be mentioned there. Thus, if you don't want to miss out on them, we recommend that you [watch the repository](https://docs.github.com/enterprise/2.15/user/articles/watching-and-unwatching-repositories).

0 commit comments

Comments
 (0)