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
A PowerShell RFC (Request for Comments) is a publication to propose design changes and improvements to PowerShell.
13
-
This provides the community an opportunity to provide feedback before code is written where it becomes harder to change at the risk of
13
+
This provides the community an opportunity to provide feedback before code is written where it becomes harder to change at the risk of
14
14
compatibility.
15
15
The complete list of RFCs are available at https://github.com/powershell/powershell-rfc
16
16
@@ -33,7 +33,7 @@ This process was adapted from the Chef RFC process as well as from the DMTF.org
33
33
34
34
RFC documents shall follow the following template:
35
35
36
-
```markdown
36
+
````markdown
37
37
---
38
38
RFC: RFC<four digit unique incrementing number assigned by Committee, this shall be left blank by the author>
39
39
Author: <First Last>
@@ -55,18 +55,31 @@ Description and rationale.
55
55
I can <<functionality>>,
56
56
so that <<benefit>>.
57
57
58
+
## User Experience
59
+
60
+
Example of user experience with example code/script.
61
+
Include example of input and output.
62
+
63
+
```powershell
64
+
Get-Example
65
+
```
66
+
67
+
```output
68
+
Hello World
69
+
```
70
+
58
71
## Specification
59
72
60
73
## Alternate Proposals and Considerations
61
74
62
-
```
75
+
````
63
76
64
77
## RFC Workflow
65
78
66
79
RFCs may go through the following stages:
67
80
68
81
### Draft
69
-
82
+
70
83
This is the initial draft of an RFC posted for comments and considered a work-in-progress.
71
84
72
85
* New proposed drafts should be submitted as a Pull Request from the Author's fork into the `Draft-Accepted` folder.
@@ -75,15 +88,15 @@ This is the initial draft of an RFC posted for comments and considered a work-in
75
88
Typically, one or two months is allowed for comments, though this may be extended if a submission is particularly contentious or hasn't received enough feedback for the Committee to feel comfortable making a decision.
76
89
* When the Committee closes the comment period, the Author should update the RFC and Pull Request with a new commit to address the comments.
77
90
* The Committee shall vote to merge or reject the RFC.
78
-
Note: the Comittee may be slower to respond to RFCs where the Author has indicated that they do not plan to implement the RFC.
91
+
Note: the Committee may be slower to respond to RFCs where the Author has indicated that they do not plan to implement the RFC.
79
92
80
93
### Draft-Accepted
81
94
82
95
The PowerShell Committee has reviewed the RFC and comments, and has voted to accept the RFC as a Draft.
83
96
84
97
* New comments are not being sought.
85
98
* No one has begun implementing the RFC, and there are no current plans to implement the RFC.
86
-
In this case, the Comittee will create `up-for-grabs` Issues in the [PowerShell](https://github.com/PowerShell/PowerShell) repository.
99
+
In this case, the Committee will create `up-for-grabs` Issues in the [PowerShell](https://github.com/PowerShell/PowerShell) repository.
87
100
88
101
### Experimental
89
102
@@ -93,7 +106,7 @@ RFCs in the `Experimental` stage have been accepted by the Committee, and code i
93
106
94
107
Feedback from the experimental implementation and RFC have been reviewed.
95
108
96
-
Because this working prototype already exists in preview builds available on GitHub, the community provide feedback on the implementation as issues in the [PowerShell/PowerShell repository](https://github.com/powershell/powershell)
109
+
Because this working prototype already exists in preview builds available on GitHub, the community provide feedback on the implementation as issues in the [PowerShell/PowerShell repository](https://github.com/powershell/powershell)
97
110
98
111
As the engineering team or code contributor works towards a final implementation, they should submit pull requests to PowerShell-RFC in order to keep the RFC in sync with the implementation.
99
112
These pull requests shall be reviewed and accepted by the Committee, but a formal vote is not necessary.
@@ -114,6 +127,7 @@ Any proposed changes should be made through a new RFC or via an Issue in the [Po
114
127
New RFCs should reference old RFCs where applicable.
115
128
116
129
## History
130
+
117
131
v1.1 - 5-20-2016 - Updated to enable RFCs for design changes that don't require code changes.
118
132
Added Draft-Accepted state and Version header property.
0 commit comments