Discourse and on-chain Proposals
There are two different kinds of proposals:
Discourse is our main tool for preparing and discussing proposals that later can be voted on. Our aim is to prepare and discuss proposals in advance and then execute them with an on-chain vote on realms. A proper proposal should always have some kind of reference to either a Discourse [Discussion] or a post so that the people who vote are able to understand the background of the proposal.
Since, for the time being, on-chain votes on realms can only have a binary outcome, multiple-choice votes are done on Discourse.
On Discourse, we use polls for voting. To create a poll use the poll builder which can be accessed from the
in the topic composer:
This will appear once you have pressed ‘build poll’:
To show advanced options press the
icon. This will show you different poll options such as poll auto close, groups allowed to vote etc.
- Single Choice: Default poll type. Users can select a single choice from the poll (This is the default option you want to choose for a YES|NO|ABSTAIN vote).
- Multiple Choice: Users can select multiple choices from the poll.The poll creator must also define the minimum and maximum number of choices a user can make. By default, the minimum will be 1, and the maximum will be the number of poll choices.
- Number Rating: Users can select a single number.The poll creator must also define the min, max and step for the number rating. For example, if the min is
2, the max is
10, and the step is
2, the options will be 2, 4, 6, 8, and 10.
- Always visible: Default poll results. Users can always see the results of the poll, regardless of if they’ve voted.
- Only after voting: Users must vote before they can see the results of the poll.
- When the poll is closed: Poll results will only be revealed once the poll is closed.
- Staff only: Only site staff will be able to see the poll results.
Discourse polls can be used for a pre-selection to find a viable solution out of different options which then can be put to an on-chain vote.
Everyone who has 200.000 $GRAPE or more on realms is able to create proposals.
Once in the creation screen, there are two options to proceed with setting up the proposal (, see below). A short, precise title helps since the proposal will most like be shared a lot. The description can either be done:
Realms only supports a limited amount of characters. If you want to post a proposal with a text >250 characters, you need to use GitHub Gist.
Proposals, in general, should be clear, concise, and informative. They should also contain a reference link that directs a reader/voter to the proposals' origin (e.g. Discourse).
Preparing a proposal
If you create a proposal using GitHub Gist, paste only the link in the field 'Description' ; putting anything else will fail on execution and the GitHub Gist content won't be parsed. Here is a template and this is some markup (not everything will show correctly). This is what the template proposal looks like.
In order to create a proposal without any on-chain instruction, just select 'None' and choose any wallet under 'Governance' . If you want to add any on-chain instructions, simply choose the transaction type and the correct wallet. Be extra cautious and better check twice. You can always save the proposal as a draft and let a fellow DAO Member cross-check it.
Once you select 'Save draft' or 'Add proposal'  you neither can change the instructions nor the title! Right now, the description can be changed if you're using GitHub Gist. Basically, the only difference with a draft is that the proposal isn't live.