csharplang/proposals/README.md
Scott Dorman 9093b4feda Consitency updates between C# and VB repos.
Updated the README.md files for consitency between the C# and VB repos.
2017-02-01 16:12:01 -05:00

2.3 KiB

C# Language Proposals

Language proposals are living documents describing the current thinking about a give language feature.

Proposals can be either active, inactive, rejected or done. Active proposals are stored directly in the proposals folder, inactive and rejected proposals are stored in the inactive and rejected subfolders, and done proposals are archived in a folder corresponding to the language version they are part of.

Lifetime of a proposal

A proposal starts its life when the language design team decides that it might make a good addition to the language some day. Typically it will start out being active, but if we want to capture an idea without wanting to work on it right now, a proposal can also start out in the inactive subfolder. Proposals may even start out directly in the rejected state, if we want to make a record of something we don't intend to do. For instance, if a popular and recurring request is not possible to implement, we can capture that as a rejected proposal.

The proposal may start out as an idea on the mailing list, or it may come from discussions in the LDM, or arrive from many other fronts. The main thing is that the design team feels that it should be done, and that there's someone who is willing to write it up.

A proposal is active if it is moving forward through design and implementation towards an upcoming release. Once it is completely done, i.e. an implementation has been merged into a release and the feature has been specified, it is moved into a subdirectory corresponding to its release.

If a feature turns out not to be likely to make it into the language at all, e.g. because it proves unfeasible, does not seem to add enough value or just isn't right for the language, it will be rejected, and moved to the corresponding subfolder. If a feature has reasonable promise but is not currently being prioritized to work on, it is inactive and will be moved to the corresponding subfolder. It is perfectly fine for work to happen on inactive or rejected proposals, and for them to be resurrected later. The categories are there to reflect current design intent.

Discussion of proposals

Feedback and discussion happens on the C# design mailing list. When a new proposal is added, it should be announced on the mailing list.