PowerShell / PowerShell/PowerShell-RFC

RFC Proposal Template enhancement suggestion

Ouverte
#211 0 commentaires 2 réactions 0 personnes assignées Voir sur GitHub

Personne n'a encore pris cette issue.

Langage dominant
PowerShell
Étoiles
467
Forks
140
Merge moyen
9 min
PR mergées (30 j)
1

Description

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?

Guide de contribution

Ouvrir le guide de contribution

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Piste de recherche

Repérez le modèle RFC existant dans le dépôt PowerShell-RFC et comparez-le à la structure Markdown proposée dans l’issue. Ajoutez les sections convenues sur l’adoption et le support de l’implémentation, puis vérifiez que le modèle est rendu correctement et conserve ses métadonnées et ses consignes existantes.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Évaluation

Stack technique
powershell
Domaine
documentation
Type d'issue
Documentation
Difficulté
2/5
Temps estimé
1-3 heures
Activité
À l'abandon
Clarté
Plutôt claire
Accessibilité débutants
45/100

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.