Skip to content

Commit

Permalink
Edit Learn Archive (#5665)
Browse files Browse the repository at this point in the history
* added learn archive page

* moved pages to /archive folder

fix broken links to images

* fix broken links

* added sticky banners

* fix broken links

* broken links polkadot

* broken link kusama

* bug fix kusama guide css sticky banner

* fix broken links

- edits old gov links
  • Loading branch information
filippoweb3 authored Mar 11, 2024
1 parent 94bd429 commit 1bf3d99
Show file tree
Hide file tree
Showing 35 changed files with 241 additions and 180 deletions.
2 changes: 1 addition & 1 deletion docs/build/build-parachains.md
Original file line number Diff line number Diff line change
Expand Up @@ -66,7 +66,7 @@ validators to participate in your network security are reduced.
decentralised application projects wishing to benefit from this security would want to become a
parachain to share in that pooled security.

#### [On-Chain Governance](../learn/learn-governance.md) (Thought-through Governance)
#### [On-Chain Governance](../learn/learn-polkadot-opengov.md) (Thought-through Governance)

Most governance systems in blockchains use an off-chain governance mechanism.
{{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }}'s on-chain governance encourages
Expand Down
2 changes: 1 addition & 1 deletion docs/build/build-protocol-info.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ decided to redenominate the DOT token. The redenomination does not change the nu

The redenomination took effect 72 hours after transfers were enabled, at block 1_248_326, which
occurred at approximately 16:50 UTC on 21 Aug 2020. You can find more information about the
redenomination [here](../learn/learn-redenomination.md).
redenomination [here](../learn/archive/learn-redenomination.md).

## Addresses

Expand Down
4 changes: 2 additions & 2 deletions docs/general/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -189,7 +189,7 @@ to consider precisely how benchmarking was performed for Polkadot.
The DOT (old) unit on Polkadot was at twelve decimal places, otherwise known as 1e12 Plancks. On 21
August, 2020, Denomination Day, the DOT (old) value was redenominated to 1e10 (10_000_000_000, or
ten billion) Plancks, meaning that the new DOT was valued at ten decimal places. Following the
[redenomination](../learn/learn-redenomination.md), the new DOT is called DOT.
[redenomination](../learn/archive/learn-redenomination.md), the new DOT is called DOT.

### What is the inflation rate of the DOT?

Expand Down Expand Up @@ -247,7 +247,7 @@ determined minority to overrule the vote of an apathetic majority in certain sit
mechanism is known as Adaptive Quorum Biasing. This makes proposals have a varying threshold for
approval or rejection based on what part of the governance protocol the proposal originated in. For
details on the subtleties of Polkadot's governance system, please see the
[governance page](../learn/learn-governance.md).
[governance page](../learn/learn-polkadot-opengov.md).

## Parachains

Expand Down
4 changes: 2 additions & 2 deletions docs/general/getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -199,8 +199,8 @@ requirement to create proposals, to endorse them and to vote on them when they b
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
[treasury proposal](../learn/learn-treasury.md#creating-a-treasury-proposal). DOT can also enable
you to participate in programs like the
[treasury proposal](../learn/learn-polkadot-opengov-treasury.md). DOT can also enable you to
participate in programs like the
[Thousand Validators Program](../general/thousand-validators.md#polkadot).

## Polkadot Gifts
Expand Down
7 changes: 4 additions & 3 deletions docs/general/grants.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,7 @@ The Polkadot Treasury is a pot of on-chain funds collected through transaction f
staking inefficiencies, etc. The funds held in the treasury can be spent on spending proposals. Both
Polkadot and Kusama offer everyone the opportunity to apply for funding via the treasury. See:

- [Treasury Wiki](../learn/learn-treasury.md)
- [Treasury Wiki](../learn/learn-polkadot-opengov-treasury.md)
- [Polkadot Treasury Guide](https://docs.google.com/document/d/1IZykdp2cyQavcRyZd_dgNj5DcgxgZR6kAqGdcNARu1w)
- [Kusama Treasury Guide](https://docs.google.com/document/d/1p3UQUjph5t8TVaWnTkfrI5mE-BABnM9Xvtuhdlhl6JE)

Expand All @@ -53,8 +53,9 @@ Due to high demand and spamming issues, the Kusama faucet is no longer in operat
Foundation has considered new ways to distribute KSM for people who need KSM to build.

If you are interested in obtaining KSM for building or research, you can apply through the
[Treasury](../learn/learn-treasury.md#creating-a-treasury-proposal) or receive a
[tip](../learn/learn-treasury.md#tipping) for doing something cool in the community.
[Treasury](../learn/learn-polkadot-opengov-treasury.md) or receive a
[tip](../learn/learn-polkadot-opengov-treasury.md#treasury-tracks) for doing something cool in the
community.

:::

Expand Down
2 changes: 1 addition & 1 deletion docs/general/kusama/kusama-claims.md
Original file line number Diff line number Diff line change
Expand Up @@ -260,7 +260,7 @@ Polkadot-JS UI and click "Confirm Claim."

At this point, you will see a success message if everything went right and your KSM will now be in
the account that you claimed to. Congratulations you can now participate in aspects of the Kusama
network such as [governance](../../learn/learn-governance.md) and
network such as [governance](../../learn/learn-polkadot-opengov.md) and
[staking](../../learn/learn-staking.md). During the soft launch period balance transfers will not be
enabled.

Expand Down
2 changes: 1 addition & 1 deletion docs/general/kusama/kusama-getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -192,7 +192,7 @@ requirement to create proposals, to endorse them and to vote on them when they b
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
[treasury proposal](../../learn/learn-treasury.md#creating-a-treasury-proposal).
[treasury proposal](../../learn/learn-polkadot-opengov-treasury.md).

### Kusama Gifts

Expand Down
3 changes: 1 addition & 2 deletions docs/general/kusama/kusama-social-recovery.md
Original file line number Diff line number Diff line change
Expand Up @@ -162,8 +162,7 @@ The recovery process is now complete and successful.

There is still one possible way to recover the account without going through the recovery process.
That is by using the `Root` origin. However, in order to use root permissions, you will need to
either go through the council or submit a public proposal. To learn more about governance, see
[here](../../learn/learn-governance.md).
either go through [governance](../../learn/learn-polkadot-opengov.md).

:::

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,19 +7,20 @@ keywords: [nominated proof of stake, staking, controller]
slug: ../learn-controller
---

:::info Controller accounts are deprecated
<div className="sticky">
<br />

Controller accounts are deprecated. For more information, see
The content on this page is archived. Controller accounts are deprecated. For more information, see
[this discussion](https://forum.polkadot.network/t/staking-controller-deprecation-plan-staking-ui-leads-comms/2748).

:::
</div>

Controller accounts were used for staking and were a "less-powerful" version of staking proxies.
Controllers could only sign for unbonding and rebonding funds, nominating and changing the reward
destination. The stash account was still used to bond more funds and change the controller.
Controller accounts became redundant and added unnecessary complexity to the staking mechanics.

![controller-accounts](../assets/stash-controller.png)
![controller-accounts](../../assets/stash-controller.png)

With the setup shown above, the stash account was not entirely isolated. More complicated designs to
fully isolate the stash account included having both controller and staking proxies (see below).
Expand All @@ -31,7 +32,7 @@ set to be the controller, and the account security would not have been compromis
proxy was used to sign all staking-relate transactions. Note that you needed to sign with the stash
to change the staking proxy.

![stash-as-controller](../assets/stash-as-controller.png)
![stash-as-controller](../../assets/stash-as-controller.png)

This past situation was similar to the present setup, except that now there is no option to set the
stash as controller and that the action of "changing the controller" is missing. From a practical
Expand All @@ -45,7 +46,7 @@ If the stash and controller were different accounts, the staking proxy was used
and change the controller. Thus the staking proxy was used to sign for those transactions that were
used less often and usually signed by the stash.

![stash-not-as-controller](../assets/stash-not-as-controller.png)
![stash-not-as-controller](../../assets/stash-not-as-controller.png)

From a practical perspective, there were two accounts, and we needed to remember two passwords. From
a security perspective, the party who wanted to control our staking actions was required to control
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,22 +7,22 @@ keywords: [governance, referenda, proposal, voting, endorse]
slug: ../learn-governance
---

<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>

{{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} uses a sophisticated governance
mechanism that allows it to evolve gracefully overtime at the ultimate behest of its assembled
stakeholders. The stated goal is to ensure that the majority of the stake can always command the
network.

:::info Polkadot OpenGov is live on Kusama Network

Learn about the upcoming changes to the governance on
{{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} in this
[Wiki doc on Polkadot OpenGov](./learn-polkadot-opengov.md).

:::

{{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} brings together various novel
mechanisms, including an amorphous (abstract) form of state-transition function stored on-chain
defined in a platform-agnostic language (i.e. [WebAssembly](learn-wasm.md)). It also allows for
defined in a platform-agnostic language (i.e. [WebAssembly](../learn-wasm.md)). It also allows for
several on-chain voting mechanisms, such as referenda with the novel concept of
[Adaptive Quorum Biasing](#adaptive-quorum-biasing) and batch approval voting. All changes to the
protocol must be agreed upon by stake-weighted referenda.
Expand All @@ -37,7 +37,7 @@ a referendum to let all holders, weighted by stake, make the decision.
The figure below shows an overview of Governance V1 with the key actors and different paths for
submitting a proposal that can potentially be voted on as a referendum.

![gov1-overview](../assets/gov1-overview.png)
![gov1-overview](../../assets/gov1-overview.png)

The public (i.e. token holders) can submit a proposal that gets added to the proposal queue. Here,
proposals are [endorsed](#endorsing-proposals), and the one that gets the most support will climb to
Expand Down Expand Up @@ -90,7 +90,7 @@ Referenda can be started in different ways:
:::info Starting a proposal in Governance V1

For more information about how to start a proposal, see the
[dedicated page](../maintain/archive/maintain-guides-democracy.md#proposing-an-action).
[dedicated page](../../maintain/archive/maintain-guides-democracy.md#proposing-an-action).

:::

Expand All @@ -99,9 +99,9 @@ For more information about how to start a proposal, see the
Anyone can submit a proposal by depositing the minimum amount of tokens for a certain period (number
of blocks). If someone agrees with the proposal, they may deposit the same amount of tokens to
support it - this action is called
[_endorsing_](../maintain/archive/maintain-guides-democracy.md#endorsing-a-proposal). The proposal
with the highest amount of bonded support will be selected to be a referendum in the next voting
cycle based on an [alternating voting timetable](#alternating-voting-timetable).
[_endorsing_](../../maintain/archive/maintain-guides-democracy.md#endorsing-a-proposal). The
proposal with the highest amount of bonded support will be selected to be a referendum in the next
voting cycle based on an [alternating voting timetable](#alternating-voting-timetable).

### Cancelling Proposals

Expand Down Expand Up @@ -145,7 +145,7 @@ options in voting are "aye", "nay", or abstaining entirely.
The structure of the timeline for all referenda is the same regardless of who initiates the
proposal, although the timeline length can vary (see below).

![gov1-timeline](../assets/gov1-timeline.png)
![gov1-timeline](../../assets/gov1-timeline.png)

The figure above provides a summary view of the referenda timeline for Governance V1.

Expand Down Expand Up @@ -244,7 +244,7 @@ selection depends on which entity proposed the proposal and whether all Council

Let's use the image below as an example.

![adaptive-quorum-biasing](../assets/governance/adaptive-quorum-biasing.png)
![adaptive-quorum-biasing](../../assets/governance/adaptive-quorum-biasing.png)

If a publicly submitted referendum only has a 25% turnout, the tally of _aye_ votes has to reach 66%
for it to pass since we applied **Positive Turnout Bias**. In contrast, when it has a 75% turnout,
Expand Down Expand Up @@ -356,19 +356,19 @@ below).
:::info Voluntary Locking

For more information about voluntary locking or conviction voting see
[Polkadot OpenGov](./learn-polkadot-opengov.md#voluntary-locking).
[Polkadot OpenGov](../learn-polkadot-opengov.md#voluntary-locking).

:::

### Delegations

In {{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} you can
[delegate your voting power](../maintain/archive/maintain-guides-democracy.md#delegate-a-vote) to
[delegate your voting power](../../maintain/archive/maintain-guides-democracy.md#delegate-a-vote) to
another account you trust if you are not willing to stay up-to-date with all referenda.

You can also use a [governance proxy](./learn-proxies.md#governance-proxy) to vote on behalf of your
stash account. The proxy can be yours, or you can authorize a third-party governance proxy to vote
with your stash. Learn more from the [dedicated page on Proxy Accounts](./learn-proxies.md).
You can also use a [governance proxy](../learn-proxies.md#governance-proxy) to vote on behalf of
your stash account. The proxy can be yours, or you can authorize a third-party governance proxy to
vote with your stash. Learn more from the [dedicated page on Proxy Accounts](../learn-proxies.md).

## Council

Expand All @@ -378,7 +378,7 @@ each represented as an on-chain account. On
{{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }}, the council currently consists of
{{ polkadot: 13 :polkadot }} {{ kusama: 19 :kusama }} members.

Along with [controlling the treasury](learn-treasury.md), the council is called upon primarily for
Along with [controlling the treasury](./learn-treasury.md), the council is called upon primarily for
three tasks of governance:

- Proposing sensible referenda
Expand Down Expand Up @@ -438,18 +438,18 @@ simultaneously. Voting on one does not prevent a user from voting on the other.

### How to be a council member?

![approval-vote](../assets/governance/approval-vote.png)
![approval-vote](../../assets/governance/approval-vote.png)

All stakeholders can signal their approval of any of the registered candidates.

Council elections are handled by the same [Phragmén election](../docs/learn-phragmen) process that
Council elections are handled by the same [Phragmén election](../learn-phragmen.md) process that
selects validators from the available pool based on nominations. However, token holders' votes for
councilors are isolated from any nominations they may have on validators. Council terms last for one
{{ kusama: day :kusama }}{{ polkadot: week :polkadot }}.

At the end of each term, [Phragmén election algorithm](../docs/learn-phragmen#algorithm) runs and
the result will choose the new councilors based on the vote configurations of all voters. The
election also chooses a set number of runners-up, which is currently
At the end of each term, [Phragmén election algorithm](../learn-phragmen#algorithm) runs and the
result will choose the new councilors based on the vote configurations of all voters. The election
also chooses a set number of runners-up, which is currently
{{ kusama: 12 :kusama }}{{ polkadot: 20 :polkadot }} that will remain in the queue with their votes
intact.

Expand Down
14 changes: 10 additions & 4 deletions docs/learn/learn-launch.md → docs/learn/archive/learn-launch.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,13 @@ keyword: [launch, phases, polkadot, DOT, claim, token sale, redenomination]
slug: ../learn-launch
---

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

The content on this page is archived.

</div>

The Polkadot network has a phased roll-out plan, with important milestones toward decentralization
marking each phase. Keep up-to-date with the Polkadot's phased roll-out plan at by viewing the
[roadmap](https://polkadot.network/launch-roadmap/)
Expand Down Expand Up @@ -39,7 +46,7 @@ Once Web3 Foundation was confident in the stability of the network and there was
of validator intentions, Web3 Foundation used [Sudo](https://youtu.be/InekMjJpVdo) &mdash; a
superuser account with access to governance functions &mdash; to initiate the first validator
election. Following this election, the network transitioned from PoA into its second phase,
[Nominated Proof of Stake (NPoS)](learn-staking.md), on June 18, 2020.
[Nominated Proof of Stake (NPoS)](../learn-staking.md), on June 18, 2020.

## Governance

Expand All @@ -59,9 +66,8 @@ under control of any centralized authority.

## Balance Transfers

To enable balance transfers, the community
made a public proposal for a runtime upgrade that lifted the
restriction on balance transfers. Transfer functionality was subsequently enabled on Polkadot at
To enable balance transfers, the community 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,6 +7,13 @@ keywords: [DOT, redenomination]
slug: ../learn-redenomination
---

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

The content on this page is archived.

</div>

On August 21, 2020, the redenomination of DOT, the native token on Polkadot, occurred. From this
date, one DOT (old) equals 100 new DOT.

Expand All @@ -17,7 +24,7 @@ The DOT redenomination took place on 21 August 2020, known as Denomination Day,

:::

While [DOT](../learn/learn-DOT.md) is the unit of currency on Polkadot that most people use when
While [DOT](../../learn/learn-DOT.md) is the unit of currency on Polkadot that most people use when
interacting with the system, the smallest unit of account is the Planck. A Planck's relation to DOT
is like the relation of a Satoshi to Bitcoin. Before 21 August, the DOT was denominated as 1e12
Plancks, that is, twelve decimal places. After Denomination Day, DOT is denominated as 1e10 Plancks,
Expand Down Expand Up @@ -132,7 +139,7 @@ community for a final, binding decision.

## The Outcome

![redenomination](../assets/redenomination.png)
![redenomination](../../assets/redenomination.png)

After two weeks of voting, the [results](https://polkadot.network/the-results-are-in/) of the
redenomination vote were tallied. About one-third of the total DOT in the network participated in
Expand Down
Loading

0 comments on commit 1bf3d99

Please sign in to comment.