haskell / rfcs

This repo is archived, consider using https://github.com/ghc-proposals/ghc-proposals instead
98 stars 17 forks source link

====================== RFCs for Haskell Prime

Before contributing, please read this entire document.

This repository is used to discuss and keep track of proposals for the next Haskell standard, in a process known as Haskell Prime. It is currently intended to be used similar to Rust’s RFCs repo_.

While the process is open for everyone to participate, contributing entirely new issues is currently limited to the members of the Core Language Committee.

.. contents:: Table of contents :local: :backlinks: none

.. _Rust’s RFCs repo: https://github.com/rust-lang/rfcs


Active RFCs

  1. None so far!

Is this the right place for my contribution?

The key idea of this process is making changes to the Haskell language, as described in the Haskell Report_. Here are some examples of RFCs a user might want to discuss here:

Good:

Bad:

.. _Haskell Report: https://www.haskell.org/onlinereport/haskell2010/


Proposal process

  1. Fork this repo at https://github.com/haskell/rfcs
  2. Copy 0000-template.rst to texts/0000-GOOD-NAME.rst; do not assign a number yet
  3. Fill in the template with your suggestion. Make sure the proposal is as well-written as you’d expect the final version of it to be; do not submit drafts with essential parts left out for discussion.
  4. File a pull request to this repo. (Do not rebase after this! You’re now live.)
  5. The request will be discussed in the comment thread of the pull request, if possible. A Core Language Committee member will be pronounced the Shepherd, and that member is responsible for guiding through the process, making sure it is not stalled, and an appropriate timeframe for the discussion is maintained.
  6. The request ends with the pull request being closed.

.. _Haskell Report Repo: https://github.com/haskell/haskell-report/

Successful proposals


Being successful means that a proposal may be implemented in the Haskell Report.

- The pull request is merged, giving the proposal an ID corresponding to the
  pull request.
- The document is added to the `Active RFCs`_
- The proposal contents are ready to be implemented in the `Haskell Report
  Repo`_.
- No one is appointed responsible for actually implementing the change, in
  particular neither the shepherd nor the author of the proposal.
- Changes to the proposal are now impossble, a new proposal is the place for
  this.

Unsuccessful proposals

The proposal is discarded without further action. This does not necessarily mean its ideas are never going to make it into Haskell, just that at this point it was decided not to continue the idea further. Example scenarios: