docs: set off governance for upgrade

Agoric · Feb 8, 2024 · 057cb83 · 057cb83
1 parent e00c259
commit 057cb83
Showing 1 changed file with 5 additions and 4 deletions.
diff --git a/main/guides/zoe/contract-upgrade.md b/main/guides/zoe/contract-upgrade.md
@@ -1,12 +1,13 @@
 # Contract Upgrade
 
-The result of starting a contract includes the right to upgrade the contract.
-Governance of the right to upgrade is a complex topic that we cover only briefly here.
-
-A call to [E(zoe).install(...)](/reference/zoe-api/zoe.md#e-zoe-startinstance-installation-issuerkeywordrecord-terms-privateargs) returns a record of several objects that represent different levels of access.
+The result of starting a contract includes the right to upgrade the contract. A call to [E(zoe).install(...)](/reference/zoe-api/zoe.md#e-zoe-startinstance-installation-issuerkeywordrecord-terms-privateargs) returns a record of several objects that represent different levels of access.
 The `publicFacet` and `creatorFacet` are defined by the contract.
 The `adminFacet` is defined by Zoe and includes methods to upgrade the contract.
 
+::: tip Upgrade Governance
+
+Governance of the right to upgrade is a complex topic that we cover only briefly here.
+
 - When BLD staker governance starts a contract using `swingset.CoreEval`,
   to date, the `adminFacet` is stored in the bootstrap vat, allowing
   the BLD stakers to upgrade such a contract in a later `swingset.CoreEval`.