This repository contains specifications for proposed changes to the Glasgow Haskell Compiler. The purpose of the GHC proposal process, and of the GHC Steering Committee, is to broaden the discussion of the evolution of GHC.
- Active proposals list
- All accepted proposals
- Proposal submission process
- Steering committee description
What is a proposal?
A GHC Proposal is a document describing a proposed change to the compiler, the
GHC/Haskell language, or the libraries in the
GHC.* module namespace. These
- A syntactic change to GHC/Haskell (e.g. the various
- A major change to the user-visible behaviour of the compiler (e.g. the recent
change in super-class
- The addition of major features to the compiler (e.g.
-XTypeInType, GHCi commands, type-indexed
Where can I find proposals currently under discussion?
Proposal discussion occurs on GitHub pull requests. See the Pull Requests list for the list of active discussions. To see the text of the proposal click on the Files Changed tab on corresponding Pull Request page.
Expectations from discussion participants
Members of the Haskell community are warmly invited to offer feedback on proposals. Feedback ensures that a variety of perspectives are heard, that alternative designs are considered, and that all of the pros and cons of a design are uncovered. We particularly encourage the following types of feedback,
- Completeness: Is the proposal missing a case?
- Soundness: Is the specification sound or does it include mistakes?
- Alternatives: Are all reasonable alternatives listed and discussed. Are the pros and cons argued convincingly?
- Costs: Are the costs for implementation believable? How much would this hinder learning the language?
- Other questions: Ask critical questions that need to be resolved.
- Motivation: Is the motivation reasonable?
How do I comment on a proposal?
To comment on a proposal you need to be viewing the proposal's diff in "source diff" view. To switch to this view use the buttons on the top-right corner of the Files Changed tab.
Use the view selector buttons on the top right corner of the "Files Changed" tab to change between "source diff" and "rich diff" views.
Feedback on a open pull requests can be offered using both GitHub's in-line and pull request commenting features. Inline comments can be added by hovering over a line of the diff.
Hover over a line in the source diff view of a pull request and
click on the
+ to leave an inline comment
For the maintenance of general sanity, try to avoid leaving "me too" comments. If you would like to register your approval or disapproval of a particular comment or proposal, feel free to use GitHub's "Reactions" feature.
How do I submit a proposal?
See the Proposal Submission page.
How are proposals decided upon?
Proposals are ultimately evaluated by the GHC Steering Committee based upon a number of criteria and in light of community feedback.