Skip to content

Commit

Permalink
Move Maintain Archive (#5641)
Browse files Browse the repository at this point in the history
* moved maintain archive

- created /archive folder
- moved files
- updated sidebar

* moved archive within docs

* moved archive outside /docs

- fix broken links

* rm gov links from maintain index

* Update docs/maintain/maintain-guides-validator-community.md

Co-authored-by: Radha <[email protected]>

* Update docs/learn/learn-launch.md

Co-authored-by: Radha <[email protected]>

* add banners, edits

* rm RPC calls deprecated pallets

- hard coded values

* added sticky banner

* fix broken link

* final edits

---------

Co-authored-by: Radha <[email protected]>
  • Loading branch information
filippoweb3 and DrW3RK authored Mar 11, 2024
1 parent da2161c commit 0eb1fb6
Show file tree
Hide file tree
Showing 12 changed files with 108 additions and 71 deletions.
4 changes: 2 additions & 2 deletions docs/general/getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -194,8 +194,8 @@ Explore Polkadot with a secure and user-friendly wallets listed on the
- {{ polkadot: __<RPC network="polkadot" path="query.nominationPools.minCreateBond" defaultValue={5000000000000} filter="humanReadable"/>:__ :polkadot }}
you can create your own [nomination pool](../learn/learn-nomination-pools.md).

DOT has utility in [Polkadot's democracy](../maintain/maintain-guides-democracy.md). Bonding DOT is
a requirement to create proposals, to endorse them and to vote on them when they become referendums.
DOT has utility in [Polkadot's OpenGov](../learn/learn-polkadot-opengov.md). Bonding DOT is a
requirement to create proposals, to endorse them and to vote on them when they become referendums.
Bonding
{{ polkadot: <RPC network="polkadot" path="consts.treasury.proposalBondMinimum" defaultValue={1000000000000} filter="humanReadable"/> :polkadot }}
or 5% of requested funding is a requirement to make a
Expand Down
4 changes: 2 additions & 2 deletions docs/general/kusama/kusama-getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -187,8 +187,8 @@ governance, acquisition of a parachain slot and for enabling several key functio
- {{ kusama: __<RPC network="kusama" path="query.staking.minimumActiveStake" defaultValue={0} filter="humanReadable"/>:__ :kusama }}
the minimum amount of KSM required to become an active nominator and earn rewards.

KSM has utility in [Kusama's democracy](../../maintain/maintain-guides-democracy.md). Bonding KSM is
a requirement to create proposals, to endorse them and to vote on them when they become referendums.
KSM has utility in [Kusama's OpenGov](../../learn/learn-polkadot-opengov.md). Bonding KSM is a
requirement to create proposals, to endorse them and to vote on them when they become referendums.
Bonding
{{ kusama: <RPC network="kusama" path="consts.treasury.proposalBondMinimum" defaultValue={666666666000} filter="humanReadable"/> :kusama }}
or 5% of requested funding is a requirement to make a
Expand Down
5 changes: 2 additions & 3 deletions docs/learn/learn-guides-ledger.md
Original file line number Diff line number Diff line change
Expand Up @@ -123,7 +123,6 @@ Check out
the learn how to remove democracy locks after the end of a Governance referendum.

**Please be advised**: Despite the Polkadot ledger application being compatible with both the Ledger
Nano S and the Ledger Nano X, none of the [Democracy](../maintain/maintain-guides-democracy.md)
extrinsics are available in the light version. The following
Nano S and the Ledger Nano X, some extrinsics are not supported by the light version. The following
[repository by Zondax](https://github.com/Zondax/ledger-polkadot) lists the currently supported
Democracy extrinsics on the full ledger.
extrinsics on the XL version of the Ledger app.
4 changes: 2 additions & 2 deletions docs/learn/learn-launch.md
Original file line number Diff line number Diff line change
Expand Up @@ -60,8 +60,8 @@ under control of any centralized authority.
## Balance Transfers

To enable balance transfers, the community
[made a public proposal](../maintain/maintain-guides-democracy.md) for a runtime upgrade that lifted
the restriction on balance transfers. Transfer functionality was subsequently enabled on Polkadot at
made a public proposal for a runtime upgrade that lifted the
restriction on balance transfers. Transfer functionality was subsequently enabled on Polkadot at
block number 1_205_128 on August 18, 2020, at 16:39 UTC.

## Core Functionality
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,26 +7,25 @@ keywords: [democracy, council, action, proposal]
slug: ../maintain-guides-democracy
---

:::caution Polkadot OpenGov is Live! This document will soon be archived.
<div className="sticky">
<br />

Polkadot OpenGov: Polkadot’s next generation of decentralized governance is live on Polkadot and
Kusama. Check the [Polkadot OpenGov page](../learn/learn-polkadot-opengov.md) for a detailed
explanation of the latest features of Polkadot governance. The democracy pallet (Gov1) will soon be
deprecated.
The content on this page is archived. For up-to-date information about governance, see the
[Polkadot OpenGov page](../../learn/learn-polkadot-opengov.md).

:::
</div>

The public referenda chamber is one of the three bodies of on-chain governance as it's instantiated
in Polkadot and Kusama. The other two bodies are the
[council](maintain-guides-how-to-join-council.md) and the
[technical committee](../learn/learn-governance.md#technical-committee).
[council](./maintain-guides-how-to-join-council.md) and the
[technical committee](../../learn/learn-governance.md#technical-committee).

Public referenda can be proposed and voted on by any token holder in the system as long as they
provide a bond. After a proposal is made, others can agree with it by _endorsing_ it and putting up
tokens equal to the original bond. During every launch period, the most endorsed proposal will be
moved to the public referenda table where it can be voted upon. Voters who are willing to lock up
their tokens for a greater duration of time can do so and get their votes amplified. For more
details on the governance system please see [here](../learn/learn-governance.md).
details on the governance system please see [here](../../learn/learn-governance.md).

This guide will instruct token holders how to propose and vote on public referenda using the
Democracy module. Below are a few links to stay informed and directly engage with the community.
Expand Down Expand Up @@ -86,22 +85,22 @@ would be `0x8ac3f722caf7677254e25ca4ad77d533ca893c7d2ad4009e258d749f2004ef94`. Y
preimage hash and save it for the next step. There is no need to click Submit Preimage at this
point, though you could. We'll go over that in the next section.

![submit preimage](../assets/democracy/submit_preimage.png)
![submit preimage](../../assets/democracy/submit_preimage.png)

Now you will click on the "Submit proposal" button and enter the preimage hash in the input titled
"preimage hash" and _at least_ the minimum deposit into the "locked balance" field. Click on the
"Submit proposal" button and confirm the transaction. You should now see your proposal appear in the
"proposals" column on the page.

![submit proposal](../assets/democracy/submit_proposal.png)
![submit proposal](../../assets/democracy/submit_proposal.png)

Now your proposal is visible to anyone who accesses the chain and others can endorse it or submit a
preimage. However, it's hard to tell what exactly this proposal does since it shows the hash of the
action. Other holders will not be able to make a judgement on whether they endorse it or not until
someone submits the actual preimage for this proposal. In the next step, you will submit the
preimage.

![proposal hash](../assets/democracy/proposal-hash.png)
![proposal hash](../../assets/democracy/proposal-hash.png)

## Submitting a Preimage

Expand All @@ -118,12 +117,12 @@ Click on the blue "Submit preimage" button and configure it to be the same as wh
acquire the preimage hash. This time, instead of copying the hash to another tab, you will follow
through and click "Submit preimage" and confirm the transaction.

![submit preimage](../assets/democracy/submit_preimage.png)
![submit preimage](../../assets/democracy/submit_preimage.png)

Once the transaction is included you should see the UI update with the information for your already
submitted proposal.

![proposals](../assets/democracy/proposals.png)
![proposals](../../assets/democracy/proposals.png)

## Endorsing a Proposal

Expand All @@ -148,16 +147,16 @@ Thus, no restrictions are made on the number of times a single account can endor
To endorse a proposal, navigate to the proposal you want to endorse and click on the "Endorse"
button.

![endorsement button](../assets/democracy/endorse1.png)
![endorsement button](../../assets/democracy/endorse1.png)

You will be prompted with the full details of the proposal (if the preimage has been submitted!) and
can then broadcast the transaction by clicking the blue "Endorse" button.

![endorsement confirmed](../assets/democracy/endorse.png)
![endorsement confirmed](../../assets/democracy/endorse.png)

Once successful, you will see your endorsement appear in the dropdown in the proposal details.

![endorsement result](../assets/democracy/endorsed-list.png)
![endorsement result](../../assets/democracy/endorsed-list.png)

## Voting on a Proposal

Expand Down Expand Up @@ -194,28 +193,28 @@ tokens already locked by staking.
When you are comfortable with the decision you have made, click the blue "Vote" button to submit
your transaction and wait for it to be included in a block.

![voting](../assets/democracy/voting.png)
![voting](../../assets/democracy/voting.png)

## Unlocking Locked Tokens

Like [vesting](../learn/learn-DOT.md#lazy-vesting), the tokens that are locked in democracy are
Like [vesting](../../learn/learn-DOT.md#lazy-vesting), the tokens that are locked in democracy are
unlocked lazily. This means that you, the user, must explicitly call an unlock extrinsic to make
your funds available again after the lock expires. Unbonding is another term you hear a lot in
Polkadot, it means withdrawing your DOT that was used in staking. To know more about it, please see
[here](maintain-guides-how-to-nominate-polkadot.md).
[here](../maintain-guides-how-to-nominate-polkadot.md).

You can do this from the "Accounts" page in
[Polkadot-JS Apps](https://polkadot.js.org/apps/#/accounts), unless you use Ledger (see below).
First, check that your account has a "democracy" lock by opening the details on your balance. In the
example below the account has 150 KSM locked in democracy.

![democracy balance details](../assets/democracy_balance_details.png)
![democracy balance details](../../assets/democracy_balance_details.png)

Now you can click the menu button (the three dots) and find the option that says "Clear expired
democracy locks". After selecting this option you may confirm the transaction and your locks will be
cleared when successful.

![democracy clear locks](../assets/democracy_clear_locks.png)
![democracy clear locks](../../assets/democracy_clear_locks.png)

#### With a Ledger hardware wallet or Unlocking Very Old Locks

Expand All @@ -234,12 +233,12 @@ The number of the referendum for which you voted is visible in an explorer such

You need to press the "Submit Transaction" button to submit the extrinsic.

![democracy clear_lock_extrinsic_1](../assets/democracy_clear_lock_extrinsic_1.png)
![democracy clear_lock_extrinsic_1](../../assets/democracy_clear_lock_extrinsic_1.png)

Now submit the following extrinsic: `democracy.unlock(target), where the target is your account
address.

![democracy clear_lock_extrinsic_2](../assets/democracy_clear_lock_extrinsic_2.png)
![democracy clear_lock_extrinsic_2](../../assets/democracy_clear_lock_extrinsic_2.png)

If you return to the [Accounts page](https://polkadot.js.org/apps/#/accounts), you should see that
the democracy lock has been released.
Expand Down Expand Up @@ -269,7 +268,7 @@ your choice. Then you would be presented with a pop-up window which lets you ent
details of the delegated account, delegated amount and conviction. You can enter the relevant
details and click on the delegate button and then sign and submit the transaction.

![delegate](../assets/democracy/delegate-vote.png)
![delegate](../../assets/democracy/delegate-vote.png)

Your delegation will count toward whatever account you delegated for votes on until you explicitly
undelegate your vote.
Expand All @@ -279,7 +278,7 @@ undelegate your vote.
It is possible to query the delegation preferences of any actively delegating account on the network
through `democracy.votingOf` extrinsic.

![query delegation](../assets/democracy/query-delegation.png)
![query delegation](../../assets/democracy/query-delegation.png)

:::

Expand Down Expand Up @@ -325,13 +324,13 @@ The easiest way to do this is from the
["Accounts" tab on Polkadot-JS UI](https://polkadot.js.org/apps/#/accounts) where you can manage the
delegation of your account.

![manage delegation](../assets/democracy/manage-delegation.png)
![manage delegation](../../assets/democracy/manage-delegation.png)

When you click on "manage delegation", you would be presented with a pre-populated pop-up window
with that account's delegation preferences. Here, you have an option to undelegate or save the
modifications made to the account's delegation preferences.

![undelegate](../assets/democracy/undelegate-save.png)
![undelegate](../../assets/democracy/undelegate-save.png)

## Voting with a Governance Proxy

Expand All @@ -341,7 +340,7 @@ pallet, and you will specify the index of the referendum that is being voted, th
"Aye" for approval or "Nay" for rejection), and the conviction, just like a normal vote.

For more material on adding and removing Governance proxies, as well as other types, please see the
[Proxy page](../learn/learn-proxies.md).
[Proxy page](../../learn/learn-proxies.md).

## Interpreting On-Chain Voting Data

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,11 +7,19 @@ keywords: [council, how to join council, governance, candidate]
slug: ../maintain-guides-how-to-join-council
---

<div className="sticky">
<br />

The content on this page is archived. For up-to-date information about governance, see the
[Polkadot OpenGov page](../../learn/learn-polkadot-opengov.md).

</div>

The council is an elected body of on-chain accounts that are intended to represent the passive
stakeholders of Polkadot and/or Kusama. The council has two major tasks in governance: proposing
referenda and vetoing dangerous or malicious referenda. For more information on the council, see the
[governance page](../learn/learn-governance.md#council). This guide will walk you through entering
your candidacy to the council.
[governance page](../../learn/learn-governance.md#council). This guide will walk you through
entering your candidacy to the council.

## Submit Candidacy

Expand All @@ -34,11 +42,11 @@ one else does.
Go to [Polkadot Apps Dashboard](https://polkadot.js.org/apps) and navigate to the "Council" tab.
Click the button on the right that says "Submit Candidacy."

![submit candidacy button](../assets/council/polkadotjs_submit_candidancy.png)
![submit candidacy button](../../assets/council/polkadotjs_submit_candidancy.png)

After making the transaction, you will see your account appear underneath the row "Candidates."

![candidates list](../assets/council/polkadotjs_candidates.png)
![candidates list](../../assets/council/polkadotjs_candidates.png)

It is a good idea now to lead by example and give yourself a vote.

Expand All @@ -47,21 +55,21 @@ It is a good idea now to lead by example and give yourself a vote.
Next to the button to submit candidacy is another button titled "Vote." You will click this button
to make a vote for yourself (optional).

![voting button on UI](../assets/council/polkadotjs_vote_button.png)
![voting button on UI](../../assets/council/polkadotjs_vote_button.png)

The council uses [Phragmén](../learn/learn-phragmen.md) approval voting, which is also used in the
validator elections. This means that you can choose up to 16 distinct candidates to vote for and
The council uses [Phragmén](../../learn/learn-phragmen.md) approval voting, which is also used in
the validator elections. This means that you can choose up to 16 distinct candidates to vote for and
your stake will equalize between them. For this guide, choose to approve your own candidacy by
clicking on the switch next to your account and changing it to say "Aye."

![voting pop up on UI](../assets/council/polkadotjs_voting.png)
![voting pop up on UI](../../assets/council/polkadotjs_voting.png)

## Winning

If you are one of the lucky ones to win a council election you will see your account move underneath
the row "Members".

![council members list](../assets/council/polkadotjs_council_members.png)
![council members list](../../assets/council/polkadotjs_council_members.png)

Now you are able to participate on the council by making motions or voting proposals. To join in on
the active discussions, join the
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,22 +7,27 @@ keywords: [council, vote, councillors]
slug: ../maintain-guides-how-to-vote-councillor
---

import RPC from "./../../components/RPC-Connection";
<div className="sticky">
<br />

The content on this page is archived. For up-to-date information about governance, see the
[Polkadot OpenGov page](../../learn/learn-polkadot-opengov.md).

</div>

The council is an elected body of on-chain accounts that are intended to represent the passive
stakeholders of Polkadot and/or Kusama. The council has two major tasks in governance: proposing
referenda and vetoing dangerous or malicious referenda. For more information on the council, see the
[governance page](../learn/learn-governance.md#council). This guide will walk you through voting for
councillors in the elections.
[governance page](../../learn/learn-governance.md#council). This guide will walk you through voting
for councillors in the elections.

## Voting for Councillors

Voting for councillors requires you to reserve
{{ polkadot: <RPC network="polkadot" path="consts.phragmenElection.votingBondBase" defaultValue={200640000000} filter = "humanReadable"/> :polkadot }}{{ kusama: <RPC network="kusama" path="consts.phragmenElection.votingBondBase" defaultValue={66879997200} filter = "humanReadable"/> :kusama }}
as a base amount and an amount of
{{ polkadot: <RPC network="polkadot" path="consts.phragmenElection.votingBondFactor" defaultValue={320000000} filter = "humanReadable"/> :polkadot }}{{ kusama: <RPC network="kusama" path="consts.phragmenElection.votingBondFactor" defaultValue={106665600} filter = "humanReadable"/> :kusama }}
per vote. You can then bond whatever amount you wish to put behind your vote. See the
[democracy guide](maintain-guides-democracy.md) for more information.
{{ polkadot: 20.064 DOT :polkadot }}{{ kusama: 0.067 KSM :kusama }} as a base amount and an amount
of {{ polkadot: 0.032 DOT :polkadot }}{{ kusama: 0.0001 KSM :kusama }} per vote. You can then bond
whatever amount you wish to put behind your vote. See the
[democracy guide](./maintain-guides-democracy.md) for more information.

:::info Voting and staking locks can overlap

Expand Down Expand Up @@ -70,7 +75,7 @@ Go to the "Governance" > "Council" tab on the

Under the "Council overview" tab, click on "Vote".

![polkadotjs_removeVoter](../assets/council/polkadotjs_removeVoter.png)
![polkadotjs_removeVoter](../../assets/council/polkadotjs_removeVoter.png)

Issue the "Unvote all" option.

Expand Down
20 changes: 20 additions & 0 deletions docs/maintain/maintain-archive.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
---
id: maintain-archive
title: Maintain Archive
sidebar_label: Archive
description: Steps on setting up a boot node.
keywords: [bootnode, web socket, remote, connection, secure websocket]
slug: ../maintain-archive
---

import DocCardList from '@theme/DocCardList';

<div className="sticky">
<br />

This section contains archived pages. The content on those pages no longer applies to Polkadot but
can still be relevant for parachains and related projects.

</div>

<DocCardList />
6 changes: 3 additions & 3 deletions docs/maintain/maintain-guides-validator-community.md
Original file line number Diff line number Diff line change
Expand Up @@ -253,9 +253,9 @@ person.
Another way to show that one cares about the network is by actively participating in governance.
Whether by voting on-chain, or by discussing off-chain, or proposing new things, active
participation in the direction of the chain is an excellent signal that a validator is there for the
network’s good. There are many ways to participate in different governance aspects, such as voting
for council members, weighing in on treasury proposals, voting on public referenda, proposing tips,
and more. See the section on [governance](maintain-guides-democracy) for additional details.
network’s good. There are many ways to participate in different governance aspects, such as weighing in on treasury proposals, voting on public referenda, delegating voting power,
and more. See the section on [Polkadot OpenGov](../learn/learn-polkadot-opengov.md) for additional
details.

#### Producing Educational Content

Expand Down
9 changes: 0 additions & 9 deletions docs/maintain/maintain-index.md
Original file line number Diff line number Diff line change
Expand Up @@ -54,12 +54,3 @@ guides to set up a node and run the network.
- [How to Chill](maintain-guides-how-to-chill.md) - Walkthrough on how to chill as a validator.
- [How to Stop Validating](maintain-guides-how-to-stop-validating.md) - Proper way to stop
validating.

## Governance

- [How to participate in Governance](maintain-guides-democracy.md) - Walkthrough on how to
participate in governance.
- [How to join the Council](maintain-guides-how-to-join-council.md) - Step by step guide for running
for the Council.
- [How to vote for a Councillor](maintain-guides-how-to-vote-councillor.md) - Step by step guide for
voting for your favorite councillors.
Loading

0 comments on commit 0eb1fb6

Please sign in to comment.