diff --git a/docs/modules/ROOT/pages/api/governance.adoc b/docs/modules/ROOT/pages/api/governance.adoc index 9e5f083b1..032b1b5c4 100644 --- a/docs/modules/ROOT/pages/api/governance.adoc +++ b/docs/modules/ROOT/pages/api/governance.adoc @@ -23,6 +23,8 @@ In a governance system, `TimelockControllerComponent` is in charge of introducin use openzeppelin_governance::timelock::interface::ITimelock; ``` +Interface of a timelock contract. + [.contract-index] .Functions -- @@ -249,6 +251,8 @@ include::../utils/_common.adoc[] use openzeppelin_governance::timelock::TimelockControllerComponent; ``` +Component that implements <> and enables the implementing contract to act as a timelock controller. + [.contract-index#TimelockControllerComponent-Embeddable-Mixin-Impl] .{mixin-impls} diff --git a/docs/modules/ROOT/pages/governance.adoc b/docs/modules/ROOT/pages/governance.adoc index 0678b3ba8..bdd1e8ce3 100644 --- a/docs/modules/ROOT/pages/governance.adoc +++ b/docs/modules/ROOT/pages/governance.adoc @@ -4,6 +4,12 @@ :accesscontrol-component: xref:api/access.adoc#AccessControlComponent[AccessControlComponent] :src5-component: xref:api/introspection.adoc#SRC5Component[SRC5Component] +Decentralized protocols are in constant evolution from the moment they are publicly released. +Often, the initial team retains control of this evolution in the first stages, but eventually delegates it to a community of stakeholders. +The process by which this community makes decisions is called on-chain governance, and it has become a central component of decentralized protocols, fueling varied decisions such as parameter tweaking, smart contract upgrades, integrations with other protocols, treasury management, grants, etc. + +The Contracts for Cairo library aims to build a modular system of governance components for users to easily integrate and customize in their contracts. + == Timelock Controller The Timelock Controller provides a means of enforcing time delays on the execution of transactions. This is considered good practice regarding governance systems because it allows users the opportunity to exit the system if they disagree with a decision before it is executed.