diff --git a/developer-docs-site/docs/concepts/governance.md b/developer-docs-site/docs/concepts/governance.md index 0d29e275cb643..4287c16e40314 100644 --- a/developer-docs-site/docs/concepts/governance.md +++ b/developer-docs-site/docs/concepts/governance.md @@ -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). @@ -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.