-
Notifications
You must be signed in to change notification settings - Fork 14
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Worked on more pages, removed blog, and updated root path.
- Loading branch information
Showing
40 changed files
with
341 additions
and
368 deletions.
There are no files selected for viewing
This file was deleted.
Oops, something went wrong.
This file was deleted.
Oops, something went wrong.
This file was deleted.
Oops, something went wrong.
Binary file not shown.
This file was deleted.
Oops, something went wrong.
This file was deleted.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,4 @@ | ||
{ | ||
"label": "Configuration", | ||
"position": 4 | ||
} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,46 @@ | ||
--- | ||
sidebar_position: 2 | ||
--- | ||
|
||
# Proposal submission | ||
|
||
Proposal submission parameters are initially set when you create a DAO. Of | ||
course you can always modify them later with a [governance | ||
proposal](/definitions/proposals) containing the `Update Proposal Submission | ||
Config` action from the `DAO Governance` category. | ||
|
||
If you have multiple choice proposals enabled, you will instead see two | ||
different actions, one labeled `Update Single Choice Proposal Submission Config` | ||
and the other labeled `Update Multiple Choice Proposal Submission Config`. | ||
|
||
The various parameters are described below. | ||
|
||
## Proposal deposit | ||
|
||
This is a required deposit someone must put down to create a proposal. This can | ||
be the DAO's governance token, if it exists, or any other token on the chain. By | ||
default, this is disabled. | ||
|
||
### Refunding proposal deposits | ||
|
||
There are three ways to handle proposal deposits: | ||
|
||
1. `Always` refund proposal deposits, regardless of whether the proposal passes | ||
or fails. | ||
2. `Only passed proposals` refund proposal deposits. | ||
3. `Never` refund proposal deposits. | ||
|
||
:::tip | ||
|
||
You may want to enable this if you are worried about spam. | ||
|
||
::: | ||
|
||
## Proposal submission policy | ||
|
||
This determines who is allowed to submit proposals to your DAO. The options are: | ||
|
||
- Only members | ||
- Anyone | ||
|
||
It defaults to `Only members`. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,23 @@ | ||
--- | ||
sidebar_position: 3 | ||
--- | ||
|
||
# Staking | ||
|
||
Token-based and NFT-based DAOs can configure the parameters of their staking | ||
process. | ||
|
||
Staking parameters are initially set when you create a DAO. Of course you can | ||
always modify them later with a [governance proposal](/definitions/proposals) | ||
containing the `Update Staking Config` action from the `DAO Governance` | ||
category. | ||
|
||
## Unstaking duration | ||
|
||
After someone stakes tokens in a DAO, those tokens cannot be immediately | ||
unstaked. The unstaking duration is how long they remain locked after deciding | ||
to unstake. During the unstaking process, they do _not_ count towards your | ||
voting power, and you cannot transfer them. | ||
|
||
This adds a time cost to staking and ensures a greater level of participatory | ||
commitment from members. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,103 @@ | ||
--- | ||
sidebar_position: 1 | ||
--- | ||
|
||
# Voting | ||
|
||
Voting parameters are initially set when you create a DAO. Of course you can | ||
always modify them later with a [governance proposal](/definitions/proposals) | ||
containing the `Update Voting Config` action from the `DAO Governance` category. | ||
|
||
If you have multiple choice proposals enabled, you will instead see two | ||
different actions, one labeled `Update Single Choice Voting Config` and the | ||
other labeled `Update Multiple Choice Voting Config`. | ||
|
||
The various parameters are described below. | ||
|
||
## Passing threshold and quorum | ||
|
||
The **_passing threshold_** is the `Yes` threshold needed to pass a proposal. It | ||
defaults to majority (i.e. any votes above 50%). It sounds simple, but it gets | ||
trick very fast because it works differently depending on whether or not the | ||
quorum is enabled. | ||
|
||
The **_quorum_** is the proportion of all voting power that must vote for a | ||
proposal to be **passable**. It defaults to 20%. For single choice proposals, | ||
quorum can be disabled. | ||
|
||
### Multiple choice proposals | ||
|
||
Multiple choice proposals use quorum in the same way, but they do not have a | ||
passing threshold. Instead, as long as the quorum is met, whichever option | ||
received more votes (i.e. the plurality of votes) wins. You cannot disable | ||
quorum for multiple choice proposals. | ||
|
||
Read on to understand how passing threshold and quorum affect each other for | ||
single choice proposals. | ||
|
||
### With quorum enabled | ||
|
||
If your DAO has a quorum set, the passing threshold is only calculated among | ||
**those who voted**. | ||
|
||
For example, with a quorum of 40% and a passing threshold of 75%, a proposal | ||
could pass with only 30% of the total voting power having voted `Yes` if exactly | ||
40% of voters vote. Imagine: 40% of the total voting power votes on the | ||
proposal. Quorum is met. Of those who voted, 75% vote `Yes`. The rest of the | ||
votes are split between `Abstain` and `No`. `Yes` will have won the vote with a | ||
75% threshold of quorum, even though only 30% of the _total_ voting power voted | ||
`Yes`. | ||
|
||
Setting quorum to 0% means that any single voter can pass a proposal by | ||
themself. _This is different from disabling quorum._ | ||
|
||
:::tip | ||
|
||
Enabling a quorum helps when there is a risk of low participation in a DAO. | ||
Large token-based DAOs likely face this risk as membership is fluid and | ||
attention is finite. Setting a quorum low enough ensures that the DAO cannot be | ||
locked due to lack of sufficient participation. However, setting a quorum too | ||
low can lead to proposals passing that do not represent enough member's | ||
preferences (if not enough people are paying attention). | ||
|
||
::: | ||
|
||
### With quorum disabled | ||
|
||
If your DAO has no quorum set, the passing threshold is calculated among **all | ||
possible voters**. This is considered an absolute threshold. | ||
|
||
For example, with a passing threshold of 67%, a proposal will pass if 67% of the | ||
total voting power voted `Yes`. | ||
|
||
:::caution | ||
|
||
Threshold and quorum can be very confusing. Please be careful and check your | ||
understanding with others before making any changes. | ||
|
||
::: | ||
|
||
## Only members execute | ||
|
||
If enabled, only members may execute passed proposals. If disabled, anyone can. | ||
This defaults to enabled. | ||
|
||
## Voting duration | ||
|
||
This is the maximum time proposals remain open for voting. | ||
|
||
## Allow revoting | ||
|
||
If enabled, votes can be changed before the voting duration ends. This defaults | ||
to disabled. | ||
|
||
:::tip | ||
|
||
When this is enabled, proposals always remain open for their entire duration. | ||
This is because the proposal outcome cannot be determined if votes can be | ||
changed. | ||
|
||
When this is disabled, proposals will pass or fail early if sufficient voters | ||
cast votes to determine an outcome. | ||
|
||
::: |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,4 @@ | ||
{ | ||
"label": "Definitions", | ||
"position": 3 | ||
} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
2 changes: 1 addition & 1 deletion
2
docs/subdaos/_category_.json → docs/definitions/subdaos/_category_.json
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,4 +1,4 @@ | ||
{ | ||
"label": "SubDAOs", | ||
"position": 6 | ||
"position": 2 | ||
} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,28 @@ | ||
--- | ||
sidebar_position: 3 | ||
--- | ||
|
||
# How to act on behalf of a SubDAO | ||
|
||
As discussed in [What are SubDAOs?](/definitions/subdaos/what), the admin (or | ||
parent DAO) can execute any action on behalf of the SubDAO. Follow this guide to | ||
learn how. | ||
|
||
|
||
|
||
In the parent DAO, create a new proposal and add the `DAO Admin Execute` action | ||
from the `DAO Governance` category. | ||
|
||
![DAO Governance category](/img/definitions/subdaos/dao-governance-category.png) | ||
|
||
Then, select the SubDAO you want to act on behalf of. | ||
|
||
![DAO Admin Execute action](/img/definitions/subdaos/dao-admin-execute.png) | ||
|
||
Then simply choose the action(s) you want to execute! | ||
|
||
![DAO Admin Execute with Manage Members | ||
action](/img/definitions/subdaos/dao-admin-execute-manage-members.png) | ||
|
||
Once you pass and execute the proposal, your action(s) will be executed on | ||
behalf of the SubDAO. |
Oops, something went wrong.