Skip to content

Commit 64f70ab

Browse files
committed
Worked on more pages, removed blog, and updated root path.
1 parent 38ab125 commit 64f70ab

40 files changed

+341
-368
lines changed

blog/2019-05-28-first-blog-post.md

Lines changed: 0 additions & 12 deletions
This file was deleted.

blog/2019-05-29-long-blog-post.md

Lines changed: 0 additions & 44 deletions
This file was deleted.

blog/2021-08-01-mdx-blog-post.mdx

Lines changed: 0 additions & 20 deletions
This file was deleted.
Binary file not shown.

blog/2021-08-26-welcome/index.md

Lines changed: 0 additions & 25 deletions
This file was deleted.

blog/authors.yml

Lines changed: 0 additions & 17 deletions
This file was deleted.

docs/configuration/_category_.json

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
{
2+
"label": "Configuration",
3+
"position": 4
4+
}
Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
---
2+
sidebar_position: 2
3+
---
4+
5+
# Proposal submission
6+
7+
Proposal submission parameters are initially set when you create a DAO. Of
8+
course you can always modify them later with a [governance
9+
proposal](/definitions/proposals) containing the `Update Proposal Submission
10+
Config` action from the `DAO Governance` category.
11+
12+
If you have multiple choice proposals enabled, you will instead see two
13+
different actions, one labeled `Update Single Choice Proposal Submission Config`
14+
and the other labeled `Update Multiple Choice Proposal Submission Config`.
15+
16+
The various parameters are described below.
17+
18+
## Proposal deposit
19+
20+
This is a required deposit someone must put down to create a proposal. This can
21+
be the DAO's governance token, if it exists, or any other token on the chain. By
22+
default, this is disabled.
23+
24+
### Refunding proposal deposits
25+
26+
There are three ways to handle proposal deposits:
27+
28+
1. `Always` refund proposal deposits, regardless of whether the proposal passes
29+
or fails.
30+
2. `Only passed proposals` refund proposal deposits.
31+
3. `Never` refund proposal deposits.
32+
33+
:::tip
34+
35+
You may want to enable this if you are worried about spam.
36+
37+
:::
38+
39+
## Proposal submission policy
40+
41+
This determines who is allowed to submit proposals to your DAO. The options are:
42+
43+
- Only members
44+
- Anyone
45+
46+
It defaults to `Only members`.

docs/configuration/staking.md

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
---
2+
sidebar_position: 3
3+
---
4+
5+
# Staking
6+
7+
Token-based and NFT-based DAOs can configure the parameters of their staking
8+
process.
9+
10+
Staking parameters are initially set when you create a DAO. Of course you can
11+
always modify them later with a [governance proposal](/definitions/proposals)
12+
containing the `Update Staking Config` action from the `DAO Governance`
13+
category.
14+
15+
## Unstaking duration
16+
17+
After someone stakes tokens in a DAO, those tokens cannot be immediately
18+
unstaked. The unstaking duration is how long they remain locked after deciding
19+
to unstake. During the unstaking process, they do _not_ count towards your
20+
voting power, and you cannot transfer them.
21+
22+
This adds a time cost to staking and ensures a greater level of participatory
23+
commitment from members.

docs/configuration/voting.md

Lines changed: 103 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,103 @@
1+
---
2+
sidebar_position: 1
3+
---
4+
5+
# Voting
6+
7+
Voting parameters are initially set when you create a DAO. Of course you can
8+
always modify them later with a [governance proposal](/definitions/proposals)
9+
containing the `Update Voting Config` action from the `DAO Governance` category.
10+
11+
If you have multiple choice proposals enabled, you will instead see two
12+
different actions, one labeled `Update Single Choice Voting Config` and the
13+
other labeled `Update Multiple Choice Voting Config`.
14+
15+
The various parameters are described below.
16+
17+
## Passing threshold and quorum
18+
19+
The **_passing threshold_** is the `Yes` threshold needed to pass a proposal. It
20+
defaults to majority (i.e. any votes above 50%). It sounds simple, but it gets
21+
trick very fast because it works differently depending on whether or not the
22+
quorum is enabled.
23+
24+
The **_quorum_** is the proportion of all voting power that must vote for a
25+
proposal to be **passable**. It defaults to 20%. For single choice proposals,
26+
quorum can be disabled.
27+
28+
### Multiple choice proposals
29+
30+
Multiple choice proposals use quorum in the same way, but they do not have a
31+
passing threshold. Instead, as long as the quorum is met, whichever option
32+
received more votes (i.e. the plurality of votes) wins. You cannot disable
33+
quorum for multiple choice proposals.
34+
35+
Read on to understand how passing threshold and quorum affect each other for
36+
single choice proposals.
37+
38+
### With quorum enabled
39+
40+
If your DAO has a quorum set, the passing threshold is only calculated among
41+
**those who voted**.
42+
43+
For example, with a quorum of 40% and a passing threshold of 75%, a proposal
44+
could pass with only 30% of the total voting power having voted `Yes` if exactly
45+
40% of voters vote. Imagine: 40% of the total voting power votes on the
46+
proposal. Quorum is met. Of those who voted, 75% vote `Yes`. The rest of the
47+
votes are split between `Abstain` and `No`. `Yes` will have won the vote with a
48+
75% threshold of quorum, even though only 30% of the _total_ voting power voted
49+
`Yes`.
50+
51+
Setting quorum to 0% means that any single voter can pass a proposal by
52+
themself. _This is different from disabling quorum._
53+
54+
:::tip
55+
56+
Enabling a quorum helps when there is a risk of low participation in a DAO.
57+
Large token-based DAOs likely face this risk as membership is fluid and
58+
attention is finite. Setting a quorum low enough ensures that the DAO cannot be
59+
locked due to lack of sufficient participation. However, setting a quorum too
60+
low can lead to proposals passing that do not represent enough member's
61+
preferences (if not enough people are paying attention).
62+
63+
:::
64+
65+
### With quorum disabled
66+
67+
If your DAO has no quorum set, the passing threshold is calculated among **all
68+
possible voters**. This is considered an absolute threshold.
69+
70+
For example, with a passing threshold of 67%, a proposal will pass if 67% of the
71+
total voting power voted `Yes`.
72+
73+
:::caution
74+
75+
Threshold and quorum can be very confusing. Please be careful and check your
76+
understanding with others before making any changes.
77+
78+
:::
79+
80+
## Only members execute
81+
82+
If enabled, only members may execute passed proposals. If disabled, anyone can.
83+
This defaults to enabled.
84+
85+
## Voting duration
86+
87+
This is the maximum time proposals remain open for voting.
88+
89+
## Allow revoting
90+
91+
If enabled, votes can be changed before the voting duration ends. This defaults
92+
to disabled.
93+
94+
:::tip
95+
96+
When this is enabled, proposals always remain open for their entire duration.
97+
This is because the proposal outcome cannot be determined if votes can be
98+
changed.
99+
100+
When this is disabled, proposals will pass or fail early if sufficient voters
101+
cast votes to determine an outcome.
102+
103+
:::

0 commit comments

Comments
 (0)