D Improvement Proposals (DIPs)
This repository stores and manages improvement proposals for the D programming language. Common examples include a change to existing language semantics, the addition of a new major features to the compiler or enforcement of new process as a standard. In general, any controversial change must be managed as a DIP and thus requires approval by the language authors and feedback from the D community.
Submitting a new D Improvement proposal
Write a document for the new improvement proposal based on the template. All sections mentioned in the template are important - for example, a change implying breaking changes has almost no chance to be accepted if it doesn't describe a migration path to mitigate breakage.
Create a new pull request against this repository by adding a new document to the
DIPsfolder, using any spare ID (>= 1000). The DIP manager will provide feedback about what information needs to be added for the DIP to reach the required quality for further consideration.
The DIP document must be named "DIP<id>.md". The exact DIP ID used at pull request stage is not important because during merging the DIP manager will replace it with the next currently available ID among the merged proposals, which will become the "real" ID for the DIP in future.
The pull request title should match the DIP title.
After any initial feedback has been addressed, the DIP manager will announce the new DIP in the official D newsgroup for community feedback. This will help evaluate stronger and weaker points of the proposal before it gets to the language author's attention.
Once a proposal includes all necessary details and the DIP manager considers it to be ready for evaluation by the language authors, the pull request gets merged with the DIP status being
Draft. A DIP pull request should not be scheduled for formal review earlier than one month after the newsgroup announcement to ensure everyone has a chance to comment on it.
Migrating an old DIP
Getting a DIP approved
- Once every few months the DIP manager has to pick one DIP from those
that currently have
Draftstatus. Proposals with more detailed descriptions and/or proof of concept implementations should have a higher priority.
- The DIP is brought to the language authors for review. The DIP manager's responsibility is to gather and provide information about the proposal at their request. After each round of review the DIP manager must publish to the mailing list the outcome of the review along with a small summary.
- Review should result in the DIP either being moved to
Approvedstatus or modified with a list of issues that need to be worked on before a final decision can be made. In the latter case such DIP may be marked with "Information Requested" status for ease of sorting. In case the DIP topic seems important but language authors decide it needs more research, a new topic on the Dlang-study mailing list may be initiated.
- Distinction between
Pending Implementationstatus is that for former just the concept itself got approval while the latter means DIP document can act as a final specification for implementing it upstream. Usually DIP that is only
Approvedwill have remarks regarding what needs to be cleaned up in spec before it can be finalized.
- If DIP was rejected during the formal review, it can't be ressurrected again. New DIP on similar topic may be submitted but it must be feature different solution.
Review Candidate Number (RC#)
Each DIP document starts with RC# 0 when it is merged into the queue. The number
is changed to
1 after preliminary NG discussion, indicating that it is ready
If more information/changes were requested, the RC number will be increased again once DIP document aggregates enough changes to become ready for another review round. Purpose of this number is to be able to easily tell amount of major revisions reviewed (while git history tracks each individual change).
Next to actual number RC# field must also mention git commit hash that matches the document version that was "tagged" to that number. Using actual git tags for this purpose was considered but is likely to result in too much noise as DIP count grows.
Collaborating on DIPs
Anyone can submit new pull requests with updates to merged DIP document as long as the original author is notified.
Discussion regarding the DIP's content is welcome in pull requests - everyone is welcome to participate in the review.
If there are many uncertainties about the proposal, consider first publishing document somewhere else and discussing it via the NG or e-mails. That will greatly reduce the number of back-and-forth changes in the DIP pull request later.
Advice for writing great DIPs
There is a dedicated document with explanations of expected DIP content and overall writing advices. Ignoring it makes chance of DIP approval very low.
DIPs by the D language authors
Language changes initiated by language authors are also supposed to go through the DIP queue. By their very nature formal approval is not needed. Hence they are processed slightly different and an increased focus is put into bringing community attention and feedback.
At the time of writing this document only Walter Bright and Andrei Alexandrescu are meant as a language authors here.
The DIP manager responsibilities
The idea behind the role of the DIP manager is to have a person who will do some minimal initial research and quality control, saving time for language authors to focus on the actual decision. That implies gathering information, maintaining this repository and communicating to involved parties so that the process keeps moving forward. Essentially the DIP manager is supposed to act as a proxy between D users and the language authors to help handling the growing scale of DIP information reliably and effectively.