move creating treasury proposal to dedicated guides page

w3f · Aug 10, 2023 · 3066674 · 3066674
1 parent f362e49
commit 3066674
Show file tree

Hide file tree

Showing 2 changed files with 105 additions and 97 deletions.
diff --git a/docs/learn/learn-guides-treasury.md b/docs/learn/learn-guides-treasury.md
@@ -6,3 +6,106 @@ description: Advanced How-to Guides about requesting funds from the Polkadot Tre
 keywords: [opengov, polkadot opengov, referenda, treasury, tips, bounties]
 slug: ../learn-guides-treasury
 ---
+
+import RPC from "./../../components/RPC-Connection";
+
+## Creating a Treasury Proposal
+
+Your proposal should address a problem, outline a goal, give a detailed account of how you will
+reach that goal, and include any ongoing maintenance needs. As much as possible, you should itemize
+the tasks to be completed so fees can be evaluated and milestones can be followed. You can check the
+{{ polkadot: [guidelines for a successful proposal](https://docs.google.com/document/d/1IZykdp2cyQavcRyZd_dgNj5DcgxgZR6kAqGdcNARu1w) :polkadot }}{{ kusama:  [guidelines for a successful proposal](https://docs.google.com/document/d/1CzEnurqwqLBOGrJI9CQORiGW9m6QyPOSshhzJdR57Pk)  :kusama }}
+and fill out the
+{{ polkadot: [Treasury proposal template](https://docs.google.com/document/d/1O_84mXYFERCavmnJyxbIPKFkG0bVBySRjCVy-d-VKcc) :polkadot }}{{ kusama:  Treasury proposal template :kusama }}
+provided.
+
+### Announcing the Proposal
+
+To minimize storage on chain, proposals don't contain contextual information. When a user submits a
+proposal, they will need to find an off-chain way to explain the proposal:
+
+- Many community members participate in discussion in the
+  {{ polkadot: [Polkadot Watercooler](https://matrix.to/#/#polkadot-watercooler:web3.foundation) and :polkadot }}
+  {{ kusama: [Kusama Direction room](https://matrix.to/#/#Kusama-Direction:parity.io) and the :kusama }}
+  {{ polkadot: [Polkadot Direction room](https://matrix.to/#/#Polkadot-Direction:parity.io). :polkadot }}
+  {{ kusama: [Kusama Watercooler](https://matrix.to/#/#kusamawatercooler:polkadot.builders). :kusama }}
+- Use platforms like [Polkassembly](https://polkassembly.io) and
+  [SubSquare](https://www.subsquare.io/) to initiate discussion with the community. They also offer
+  a gauge poll to capture the community sentiment before submitting an on-chain referendum.
+
+Spreading the word about the proposal's explanation to the community is ultimately up to the
+proposer.
+
+:::tip Use Accounts with Verified On-Chain Identity for Treasury Proposals
+
+To ensure legitimacy, it is required that the account linked to the Treasury proposal has an
+[identity set](https://support.polkadot.network/support/solutions/articles/65000181981-how-to-set-and-clear-an-identity)
+and is
+[verified by an on-chain registrar](https://support.polkadot.network/support/solutions/articles/65000181990-how-to-request-and-cancel-identity-judgement).
+
+:::
+
+### Submit Treasury Proposal Preimage
+
+The example below shows how to create a [preimage](../general/glossary#preimage) for a transaction
+that requests 100 DOT from Treasury.
+
+- Navigate to [Polkadot-JS UI > Governance > Preimages](https://polkadot.js.org/apps/#/preimages)
+  and then click on Add Preimage.
+- Select the account which will be used to submit the preimage.
+- Choose `treasury` pallet in the "propose" dropdown and the `spend(amount, beneficiary)`call
+- Enter the DOT amount.
+- Enter the AccountID of the beneficiary (which has a verified on-chain identity).
+- Submit preimage
+- Sign and submit the transaction by paying the specified transaction fees.
+
+:::info Preimage Submission Deposit
+
+A deposit is required for the preimage to be stored on chain. The deposit amount required for a
+preimage with a treasury spend transaction is around
+{{ polkadot: 41 DOT :polkadot }}{{ kusama:  1.4 KSM  :kusama }}. Ensure you have enough account
+balance to pay for the submission deposit and the transaction fees.
+
+:::
+
+![Treasury Preimage](../assets/treasury/treasury-preimage.png)
+
+After successful submission of the preimage, it is displayed on Polkadot-JS UI > Governance >
+Preimages page. Every preimage is associated with a unique preimage hash (highlighted in a box in
+the image below). Take a note of this preimage hash, which is required to submit a referendum.
+
+![Treasury Preimage Hash](../assets/treasury/treasury-preimage-hash.png)
+
+### Submit a Treasury Track Referendum
+
+The example below shows how to submit a Treasury track referendum.
+
+- Navigate to [Polkadot-JS UI > Governance > Referenda](https://polkadot.js.org/apps/#/referenda)
+  and then click on Submit proposal.
+- Select the account which will be used to submit the proposal.
+- Choose the appropriate submission track (The example below selected Small Spender track).
+- Enter the preimage hash of the treasury spend transaction.(If the preimage exists on-chain, the
+  preimage length box is automatically populated)
+- Click on Submit proposal.
+- Sign and submit the transaction.
+
+![Submit Treasury Proposal](../assets/treasury/submit-proposal-treasury.png)
+
+Once your submission is executed, your referendum will appear under your chosen track on the
+Polkadot-JS UI [referenda page](https://polkadot.js.org/apps/#/referenda).
+
+### Place a Decision Deposit for the Treasury Track Referendum
+
+For the referendum to move from preparing phase to the deciding phase, a decision deposit needs to
+be placed. The decision deposit values for each individual [Treasury Tracks](#treasury-tracks) are
+listed in a section above in this document.
+
+![Submit Treasury Proposal Decision Deposit](../assets/treasury/treasury-proposal-decision-deposit.png)
+
+### Claiming the Preimage and Decision Deposits
+
+After the referendum finishes its life cycle (and gets approved or rejected or timed out), the
+deposits can be claimed. For claiming the preimage deposit, navigate to Polkadot-JS UI >
+Governance > Preimages and click on unnote button shown on the preimage you submitted. Similarly, to
+claim the decision deposit, navigate to Polkadot-JS UI > Governance > Referenda and scroll down to
+the end of the page to click on the referenda with the decision depoit and claim it.
diff --git a/docs/learn/learn-polkadot-opengov-treasury.md b/docs/learn/learn-polkadot-opengov-treasury.md
@@ -58,8 +58,8 @@ OpenGov allows for managing funds through six tracks, each with its own
 :::info How to access Treasury funds?
 
 Access to Treasury funds requires successful enactment of referendum in the respective treasury
-track on-chain. Learn how to create a referendum
-[here](../maintain/maintain-guides-polkadot-opengov.md#create-a-referenda-proposal-using-polkadot-js-ui).
+track on-chain. Learn how to submit a treasury proposal for referendum
+[here](./learn-guides-treasury.md#creating-a-treasury-proposal).
 
 :::
 
@@ -100,98 +100,3 @@ requires a decision deposit of {{ polkadot: 10 DOT :polkadot }}{{ kusama:  0.33
 This track can be used for treasury spending requests up to
 {{ polkadot: 100 DOT :polkadot }}{{ kusama:  8.25 KSM  :kusama }} per referendum. Each referendum
 requires a decision deposit of {{ polkadot: 1 DOT :polkadot }}{{ kusama:  0.033 KSM  :kusama }}.
-
-## Creating a Treasury Proposal
-
-Your proposal should address a problem, outline a goal, give a detailed account of how you will
-reach that goal, and include any ongoing maintenance needs. As much as possible, you should itemize
-the tasks to be completed so fees can be evaluated and milestones can be followed. You can check the
-{{ polkadot: [guidelines for a successful proposal](https://docs.google.com/document/d/1IZykdp2cyQavcRyZd_dgNj5DcgxgZR6kAqGdcNARu1w) :polkadot }}{{ kusama:  [guidelines for a successful proposal](https://docs.google.com/document/d/1CzEnurqwqLBOGrJI9CQORiGW9m6QyPOSshhzJdR57Pk)  :kusama }}
-and fill out the {{ polkadot: [Treasury proposal template](https://docs.google.com/document/d/1O_84mXYFERCavmnJyxbIPKFkG0bVBySRjCVy-d-VKcc) :polkadot }}{{ kusama:  Treasury proposal template :kusama }} provided.
-
-### Announcing the Proposal
-
-To minimize storage on chain, proposals don't contain contextual information. When a user submits a
-proposal, they will need to find an off-chain way to explain the proposal:
-
-- Many community members participate in discussion in the
-  {{ polkadot: [Polkadot Watercooler](https://matrix.to/#/#polkadot-watercooler:web3.foundation) and :polkadot }}
-  {{ kusama: [Kusama Direction room](https://matrix.to/#/#Kusama-Direction:parity.io) and the :kusama }}
-  {{ polkadot: [Polkadot Direction room](https://matrix.to/#/#Polkadot-Direction:parity.io). :polkadot }}
-  {{ kusama: [Kusama Watercooler](https://matrix.to/#/#kusamawatercooler:polkadot.builders). :kusama }}
-- Use platforms like [Polkassembly](https://polkassembly.io) and [SubSquare](https://www.subsquare.io/) to initiate discussion with the community. They also offer a gauge poll to capture the community sentiment before submitting an on-chain referendum.
-
-Spreading the word about the proposal's explanation to the community is ultimately up to the
-proposer.
-
-:::tip Use Accounts with Verified On-Chain Identity for Treasury Proposals
-
-To ensure legitimacy, it is required that the account linked to the Treasury proposal has an
-[identity set](https://support.polkadot.network/support/solutions/articles/65000181981-how-to-set-and-clear-an-identity)
-and is
-[verified by an on-chain registrar](https://support.polkadot.network/support/solutions/articles/65000181990-how-to-request-and-cancel-identity-judgement).
-
-:::
-
-### Submit Treasury Proposal Preimage
-
-The example below shows how to create a [preimage](../general/glossary#preimage) for a transaction that requests 100 DOT from
-Treasury.
-
-- Navigate to [Polkadot-JS UI > Governance > Preimages](https://polkadot.js.org/apps/#/preimages) and then click on Add Preimage.
-- Select the account which will be used to submit the preimage.
-- Choose `treasury` pallet in the "propose" dropdown and the `spend(amount, beneficiary)`call
-- Enter the DOT amount.
-- Enter the AccountID of the beneficiary (which has a verified on-chain identity).
-- Submit preimage
-- Sign and submit the transaction by paying the specified transaction fees.
-
-:::info Preimage Submission Deposit
-
-A deposit is required for the preimage to be stored on chain. The deposit amount required for a
-preimage with a treasury spend transaction is around
-{{ polkadot: 41 DOT :polkadot }}{{ kusama:  1.4 KSM  :kusama }}. Ensure you have enough account
-balance to pay for the submission deposit and the transaction fees.
-
-:::
-
-![Treasury Preimage](../assets/treasury/treasury-preimage.png)
-
-After successful submission of the preimage, it is displayed on Polkadot-JS UI > Governance >
-Preimages page. Every preimage is associated with a unique preimage hash (highlighted in a box in
-the image below). Take a note of this preimage hash, which is required to submit a referendum.
-
-![Treasury Preimage Hash](../assets/treasury/treasury-preimage-hash.png)
-
-### Submit a Treasury Track Referendum
-
-The example below shows how to submit a Treasury track referendum.
-
-- Navigate to [Polkadot-JS UI > Governance > Referenda](https://polkadot.js.org/apps/#/referenda) and then click on Submit proposal.
-- Select the account which will be used to submit the proposal.
-- Choose the appropriate submission track (The example below selected Small Spender track).
-- Enter the preimage hash of the treasury spend transaction.(If the preimage exists on-chain, the
-  preimage length box is automatically populated)
-- Click on Submit proposal.
-- Sign and submit the transaction.
-
-![Submit Treasury Proposal](../assets/treasury/submit-proposal-treasury.png)
-
-Once your submission is executed, your referendum will appear under your chosen track on the
-Polkadot-JS UI [referenda page](https://polkadot.js.org/apps/#/referenda).
-
-### Place a Decision Deposit for the Treasury Track Referendum
-
-For the referendum to move from preparing phase to the deciding phase, a decision deposit needs to
-be placed. The decision deposit values for each individual [Treasury Tracks](#treasury-tracks) are
-listed in a section above in this document.
-
-![Submit Treasury Proposal Decision Deposit](../assets/treasury/treasury-proposal-decision-deposit.png)
-
-### Claiming the Preimage and Decision Deposits
-
-After the referendum finishes its life cycle (and gets approved or rejected or timed out), the
-deposits can be claimed. For claiming the preimage deposit, navigate to Polkadot-JS UI >
-Governance > Preimages and click on unnote button shown on the preimage you submitted. Similarly, to
-claim the decision deposit, navigate to Polkadot-JS UI > Governance > Referenda and scroll down to
-the end of the page to click on the referenda with the decision depoit and claim it.