Skip to content

Latest commit

 

History

History
84 lines (53 loc) · 5.58 KB

contributing.md

File metadata and controls

84 lines (53 loc) · 5.58 KB
Raw
title
How to contribute

{::options parse_block_html="true" /}

The Eastleigh Manifesto is currently offline. Hopefully it will be back one day but if you have any ideas before then, you can still open an issue on GitHub.

This project is an open collaborative space which means anyone can get involved. This is a local political manifesto for Eastleigh, but you don't need to be a member of a party, of voting age, or even live in Eastleigh to contribute. Good ideas can come from anywhere!

  • Anyone can edit the manifesto.
  • Once a suggestion is made, project contributors vote on whether or not it’s accepted. Click “View proposals” above to see the current proposals.
  • Once a proposal is accepted, the author gets to vote on future proposals.

Getting Started

{::options parse_block_html="true" /}

  • You'll need a GitHub account before you can contribute to the manifesto; if you don't have one, you can make an account for free. GitHub is the system that stores all the changes made to the manifesto. Your account doesn't have to be linked to your real name or identity.

Code of Conduct

This project has a code of conduct. In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation. Read the complete code of conduct for the full policy, and to see what is expected of you as a contributor.

The Rules

  • You can propose a change on any page with a suggest button - even the voting rules on this page.
  • All contributions and discussions should be public - no backroom deals!
  • Plain English is important - follow the gov.uk style guide if you can, or use Hemingway to test readability. Avoid political weasel-words, especially.
  • Provide evidence and links wherever possible, to back up your case. Include them in your proposal text, either as direct links, or as footnotes.
  • Make your proposals small, self-contained, and simple. Large changes will take a lot longer to get agreed upon and merged.
  • Proposals don't need to be fully finished or hugely detailed. It's better to make small iterative improvements, as it keeps things moving faster.
  • Keep your proposals positive. New ideas are better than opposing existing policies.

Editing

  1. Read the manifesto, and find the page you want to edit. Then click the Suggest a change button at the top right.
  2. Log in with a GitHub account; if you don't have one, you can make an account for free.
  3. Make your change in the editor. Text is formatted with Markdown; you'll find instructions at the side of the editor window.
  4. If this is your first edit, please agree to the Contributor License Agreement to state that your submission is in the public domain.
  5. After you've saved your changes, your proposal will be added to the proposal list. There will then be a vote, and possibly debate, amongst contributors on whether to adopt the proposal. You can change the proposal in response to the discussion, if you want to.

If you want to contribute but aren't sure what you can start with, you can check out the ideas list for inspiration.

Voting

We use a consensus voting system, where a change is accepted if it reaches a certain threshold of yes votes.

People who have contributed to the manifesto are eligible to vote on proposals. If you get a proposal accepted, you will get a vote. It doesn't have to be a big change, as long as you contribute, you're in!

The simplest way to vote is using the voting interface. Click on the proposal details to see the change, comment, or cast a vote.

Four vote types are available:

vote symbol score
Yes ✅ 1
No ❎ -1
Abstain 🤐 0
Block 🚫 -1000
{: .table .table-striped}

Counting votes

When votes are cast, the score is counted up, and as long as the total is 2 or more, the proposal passes. If a change is amended, "yes" votes are reset, and are only counted if cast after the latest change.

Time

Proposals must be open for a minimum of 7 days, and are rejected if they're not passed within 90 days.

Blocks

Block votes are special, and are intended as a protection against fundamental changes being forced in through brigading.

If a change violates the core principles of the manifesto, any voter can use a block vote. The block vote should come with detailed reasoning and constructive comments for improvement if possible. A block can be removed by the original blocker changing to a yes or no vote. Blocks that are not explained can be overridden if enough voters agree, though this process is not strictly defined at present.

Blocks are generally discouraged; if you disagree with a proposal in a normal way, just vote "no". Blocks should only be used in extreme circumstances, such as if a proposal completely violates the principles of the manifesto.