PowerShell / PowerShell/PowerShell-RFC
RFC Proposal Template enhancement suggestion
まだ誰も着手していません。
- 主要言語
- PowerShell
- スター
- 467
- フォーク
- 140
- 平均マージ
- 9分
- マージ済み PR(30日)
- 1
説明
As use of the RFC Process grows and proposals to enhance and expand language features increases, I feel there is a need to make a minor amendment to the RFC Template to encourage RFC authors to think about the wider items outside of the RFC proposal including what others can focus on post RFC implementation that will help drive the successful education, use and adoption of these new features.
Therefore I propose that we make an amendment to the RFC template to include an additional small section where the author can outline what they think will aid the successful adoption of these new features within a newer version of the language (v7 / v8 / v9 etc) so that for those, like myself, that blog/present/stream etc can look for suggestions in areas which they can focus on for creating new content that can aid the adoption of these features. This would also help in identifying areas in the supporting tooling, for example PSScriptAnalyzer/PES, to potentially add new features that further help aid adoption. going forward.
I would also suggest to add an additional area where the RFC Author could showcase that with some support & guidance they would intent to implement as well as a section to detail any support they may require to help them be able to implement this.
This could look like the below
---
RFC: RFC<four digit unique incrementing number assigned by Committee, this shall be left blank by the author>
Author: <First Last>
Status: <Draft | Experimental | Accepted | Rejected | Withdrawn | Final>
SupercededBy: <link to another RFC>
Version: <Major>.<Minor>
Area: <Area within the PowerShell language>
Comments Due: <Date for submitting comments to current draft (minimum 1 month)>
Plan to implement: <Yes | No>
Require Support to implement: <Yes | No>
---
# Title
Description and rationale.
## Motivation
As a <<user_profile>>,
I can <<functionality>>,
so that <<benefit>>.
## User Experience
Example of user experience with example code/script.
Include example of input and output.
## Specification
## Alternate Proposals and Considerations
## Supporting Adoption
## Support required to Implement
I'll submit a PR for this change if this seems ok to others?
コントリビューションガイド
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
調査の方向性
PowerShell-RFC リポジトリにある既存の RFC テンプレートを見つけ、issue で提案されている Markdown 構成と比較します。合意された採用および実装サポートのセクションを追加し、その後、テンプレートが正しくレンダリングされ、既存のメタデータとガイダンスが維持されていることを確認します。
索引モデルが issue の本文から書いたものです。
評価
- 技術スタック
- powershell
- 領域
- documentation
- issue の種類
- ドキュメント
- 難易度
- 2/5
- 見積もり時間
- 1〜3時間
- 活発さ
- 停滞
- 明瞭さ
- おおむね明確
- 初心者へのやさしさ
- 45/100