Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Formalize the process #2

Merged
merged 1 commit into from
Aug 1, 2016
Merged

Formalize the process #2

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 24 additions & 2 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,28 @@

This project is for maintaining formal change proposals for Haxe language.

## About proposals

Haxe Proposals (HXP) can be submit by any Haxe team developer or community member, as long as it's complete and well explained.

Once an HXP has been submit, it can be discussed and modified. Anybody can also submit a PR against an existing HXP to have it amended.

After the HXP has been discussed, a formal vote can take place to accept it. Only Haxe Core Team members are allowed to vote:
- Nicolas Cannasse (Haxe creator)
- Simon Krajewski (Compiler Maintainer)
- Hugh Sanderson (Haxe C++ backend)
- Caue Waneck (Haxe C# and Java backends)
- Andy Li (tools and infrastructure)
- Dan Korostelev (compiler contributor)

To be accepted the HXP needs half + 1 votes in favor of it.

In order to keep the long term goals and vision of Haxe, Nicolas can veto any accepted proposal after the vote, but will details his reason for doing so and agree to use this power with care.

Once the HXP is accepted, the core team will work on implementing it.

## What needs a proposal?

Stuff that don't need a formal proposal (unless it's something fundamental):

* bugfixes
Expand All @@ -18,15 +40,15 @@ Stuff that most probably need a formal proposal:

Basically, everything that needs some design process and consensus among the developers is a candidate for a proposal.

## The process (NOT YET FINALIZED)
## How to submit an HXP

1. Fork the repo, copy the `0000-template.md` to `proposals/0000-short-name.md`,
where `short-name` is a descriptive filename for the proposal document. Don't assign the number yet.
2. Carefully fill in the proposal, pay attention to details: it should show your understanding
of the issue and the impact of the proposed design.
3. Submit a pull request with the proposal. In this PR, Haxe team and the community can provide
feedback for it. Be prepared to react accordingly and revise the proposal document.
4. After reaching general consensus, the PR is merged by someone from the Haxe developer team,
4. After reaching general consensus or voting takes place, the PR is merged by someone from the Haxe developer team,
and the proposal becomes "active". When merged, the proposal will receive its number from the
corresponding pull request. If the proposal is rejected, the PR is closed with a comment explaining the reasons.
5. Active proposals are to be further discussed in details by the Haxe developer team
Expand Down