Skip to content

Commit

Permalink
[docs] updated governance doc (aptos-labs#5778)
Browse files Browse the repository at this point in the history
* rebased

* Update developer-docs-site/docs/concepts/governance.md

* Update developer-docs-site/docs/concepts/governance.md

* Update developer-docs-site/docs/concepts/governance.md

* Update developer-docs-site/docs/concepts/governance.md

* Update developer-docs-site/docs/concepts/governance.md

* Update developer-docs-site/docs/concepts/governance.md

Co-authored-by: chloeqjz <[email protected]>
Co-authored-by: David Wolinsky <[email protected]>
  • Loading branch information
3 people authored and areshand committed Dec 17, 2022
1 parent 54de5b4 commit 3d8a22c
Showing 1 changed file with 22 additions and 1 deletion.
23 changes: 22 additions & 1 deletion developer-docs-site/docs/concepts/governance.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ sources={{

## Who can propose

- To either propose or vote, you must stake but you are not required to run a validator node. However, we recommend that you be a validator with a stake and be a part of the validator set.
- To either propose or vote, you must stake, but you are not required to run a validator node. However, we recommend that you run validator with a stake as part of the validator set to gain rewards from your stake.
- To create a proposal, the proposer's backing stake pool must have the minimum required proposer stake. The proposer's stake must be locked up for at least as long as the proposal's voting period. This is to avoid potential spammy proposals.
- Proposers can create a proposal by calling [`aptos_governance::create_proposal`](https://github.com/aptos-labs/aptos-core/blob/27a255ebc662817944435349afc4ec33ea317e64/aptos-move/framework/aptos-framework/sources/aptos_governance.move#L183).

Expand All @@ -45,3 +45,24 @@ sources={{
:::tip
Each stake pool can be used to vote on each proposal exactly only one time.
:::

## Who can resolve
- Anyone can resolve an on-chain proposal that has passed voting requirements by using the `aptos governance execute-proposal` command from Aptos CLI.

## Aptos Improvement Proposals (AIPs)

AIPs are proposals created by the Aptos community or the Aptos Labs team to improve the operations and development of the Aptos chain.
To submit an AIP, create an issue in [`Aptos Foundation's github repository`](https://github.com/aptos-foundation/AIPs/issues) using the [template](https://github.com/aptos-foundation/AIPs/blob/main/TEMPLATE.md)
To keep up with new AIPs, check the `#aip-announcements` channel on [Aptos' discord channel](https://discord.gg/aptoslabs).
To view and vote on on-chain proposals, go to [`Aptos' Governance website`](https://governance.aptosfoundation.org/).

## Technical Implementation of Aptos Governance
The majority of the governance logic is in [`aptos_governance.move and voting.move`](https://github.com/aptos-labs/aptos-core/blob/main/aptos-move/framework/aptos-framework/sources).
The `aptos_governance` module outlines how users can interact with Aptos Governance. It's the external-facing module of the Aptos on-chain governance process and contains logic and checks that are specific to Aptos Governance.
The `voting` module is the Aptos governance standard that can be used by DAOs on the Aptos chain to create their own on-chain governance process.

If you are thinking about creating a DAO on Aptos, you can refer to `aptos_governance`'s usage of the `voting` module as an example.
In `aptos_governance`, we rely on the `voting` module to create, vote on, and resolve a proposal.
- `aptos_governance::create_proposal` calls `voting::create_proposal` to create a proposal on-chain, when an off-chain AIP acquires sufficient importance.
- `aptos_governance::vote` calls `voting::vote` to record the vote on a proposal on-chain;
- `aptos_governance::resolve` can be called by anyone. It calls `voting::resolve` to resolve the proposal on-chain.

0 comments on commit 3d8a22c

Please sign in to comment.