git.iko.soy/urbit.org
on master help sign in
Merge pull request #1082 from urbit/upgrade-proposal

add upgrade proposals to glossary

commit04e906c713b85b315c5dd21f0f4506425053b861 authorpoprox <51337059+drbeefsupreme@users.noreply.github.com> dateWed 2 Jun 2021, 18:31 (5 years ago) parente93c3dadb3492f
5 files changed+42−5
compare with master
unifiedsplit
glossary/docvote.md+2−2 glossary/ecliptic.md+2−1 glossary/senate.md+6−1 glossary/upgrade.md+13 glossary/voting.md+19−1
glossary/docvote.md+2−2
@@ -1,9 +1,9 @@
11+++
2−title = "Document Vote"
2+title = "Document Proposal"
33
44template = "doc.html"
55[extra]
66category = "azimuth"
77+++
88
9−A **document vote** is a type of [vote](../voting) action taken by the [Galactic Senate](../senate) over [Azimuth](../azimuth). By passing a document vote, [Galaxies](../galaxy) in the Senate agree legitimize a document with arbitrary content. Such a document might make claims about the state of the world; an example document that would be subject to this type of vote might be a file that says, "@urbit_senate is the official Twitter account of the senate, and is to be managed by John Doe until further notice."
9+A **document proposal** is a type of [vote](../voting) action taken by the [Galactic Senate](../senate) over [Azimuth](../azimuth). By passing a document proposal, [Galaxies](../galaxy) in the Senate agree legitimize a document with arbitrary content. Such a document might make claims about the state of the world; an example document that would be subject to this type of vote might be a file that says, "@urbit_senate is the official Twitter account of the senate, and is to be managed by John Doe until further notice."
glossary/ecliptic.md+2−1
@@ -8,4 +8,5 @@ category = "azimuth"
88
99The **Ecliptic** contract sets the rules for what is and is not possible on Azimuth. It's the point of entry for interacting with the [Azimuth](../azimuth) ledger data; the Azimuth contract itself is just data, and the Ecliptic contract is the logic for controlling that data. Examples of such logic include verifying permissions of the person asking to access their data, and ensuring a requested change is actually valid.
1010
11−The Senate (the voting body of [galaxies](../galaxy)) has the power to replace Ecliptic.
11+The Senate (the voting body of [galaxies](../galaxy)) has the power to replace
12+Ecliptic via an [upgrade proposal](../upgrade).
glossary/senate.md+6−1
@@ -6,4 +6,9 @@ template = "doc.html"
66category = "azimuth"
77+++
88
9−The **Galactic Senate** is the body of all [galaxies](../galaxy) that governs [Azimuth](../azimuth) by [majority vote](../voting). There are two types of votes: a constitution vote, which is a motion to update the logic of Azimuth; and a [documentation vote](../docvote), which is a motion to legitimize or approve the content of an arbitrary document.
9+The **Galactic Senate** is the body of all [galaxies](../galaxy) that governs
10+[Azimuth](../azimuth) by [majority vote](../voting). There are two types of
11+votes: an [upgrade proposal](../upgrade), which is a motion to update the logic
12+of Azimuth (i.e. [Ecliptic](../ecliptic)), and a [document
13+proposal](../docvote), which is a motion to legitimize or approve the content of an
14+arbitrary document.
glossary/upgrade.mdnew file+13
@@ -0,0 +1,13 @@
1++++
2+title = "Upgrade Proposal"
3+
4+template = "doc.html"
5+[extra]
6+category = "azimuth"
7++++
8+
9+An **upgrade proposal** is a type of [vote](../voting) action taken by the
10+[Galactic Senate](../senate) over [Azimuth](../azimuth). By passing an upgrade
11+proposal, [Galaxies](../galaxy) in the Senate agree to change the
12+[Ecliptic](../ecliptic) smart contracts.
13+
glossary/voting.md+19−1
@@ -6,4 +6,22 @@ template = "doc.html"
66category = "azimuth"
77+++
88
9−**Voting** is a power available to [galaxies](../galaxy), in their capacities as members of the [Galactic Senate](../senate), through an [Azimuth](../azimuth) smart contract. Galaxies collectively make decisions about the governance of Azimuth and the [Arvo](../arvo) network by voting. There are two types of votes: a [constitution vote](../constitutionvote) and a [document vote](../docvote).
9+**Voting** is a power available to [galaxies](../galaxy), in their capacities as
10+members of the [Galactic Senate](../senate), through an [Azimuth](../azimuth)
11+smart contract. Galaxies collectively make decisions about the governance of
12+Azimuth and the [Arvo](../arvo) network by voting. There are two types of proposals that can be voted on:
13+an [upgrade proposal](../upgrade) and a [document proposal](../docvote).
14+
15+A proposal is always a Yes/No vote. The vote concludes at the end of 30 days,
16+or whenever an absolute majority is reached, whichever comes first. Assuming a
17+quorum of at least 64 galaxies (1/4 of the Senate) has been achieved, at the end
18+of 30 days the option that has received the most votes is chosen. If a quorum
19+is not achieved then no action is taken.
20+
21+In the case of an absolute majority (129 galaxies), the vote transaction that
22+achieves that majority triggers the upgrade or document ratification. If 30 days
23+passes without an absolute majority being reached, an explicit "update vote
24+status/check result" transaction will need to be made. This can be performed by
25+anyone at any time. Any effects from doing so will only take place if there was a
26+majority vote in favor.
27+