edited text

w3f · Oct 11, 2023 · 3ec1adf · 3ec1adf
1 parent 8ab9ded
commit 3ec1adf
Show file tree

Hide file tree

Showing 2 changed files with 36 additions and 22 deletions.
diff --git a/docs/learn/learn-guides-polkadot-opengov.md b/docs/learn/learn-guides-polkadot-opengov.md
@@ -73,16 +73,30 @@ have been met. Failing to submit the decision deposit within a
 {{ polkadot: <RPC network="polkadot" path="const.referenda.undecidingTimeout" defaultValue={201600} filter="blocksToDays"/> :polkadot }}{{ kusama: <RPC network="kusama" path="const.referenda.undecidingTimeout" defaultValue={201600} filter="blocksToDays"/> :kusama }}-day
 period will lead to a referendum timeout.
 
-## Request Submission and Decision Deposit Back
+## Claiming the Preimage and Decision Deposits
 
-If you submitted a proposal and a referendum for such proposal has ended, you can claim your
-submission and decision deposits back by issuing the `refundSubmissionDeposit` and the
-`refundDecisionDeposit` extrinsics, respectively. Those calls will succeed if the proposal is
-completed as passing or failing.
+After a referendum finishes its life cycle (and gets approved or rejected or timed out), the
+preimage and decision deposits can be claimed. For claiming the preimage deposit, navigate to
+[Polkadot-JS UI > Governance > Preimages](https://polkadot.js.org/apps/#/preimages) and click on
+unnote button shown on the preimage you submitted.
 
-Users can not refund their submission deposit while the referendum is `Ongoing`. Similarly, users
-cannot refund their submission deposit if the proposal has `TimedOut` (failing to submit the
-decision deposit within a
+![Claim Preimage Deposit](../assets/claim-preimage-deposit.png)
+
+Similarly, to claim the decision deposit, navigate to
+[Polkadot-JS UI > Governance > Referenda](https://polkadot.js.org/apps/#/referenda) and scroll down
+to the end of the page to click on the referenda with the decision deposit and claim it.
+
+![Claim Referendum Deposits](../assets/claim-referendum-decision-deposit.png)
+
+## Claiming the Submission Deposit
+
+The submission deposit for a referendum can be claimed
+[only if the referendum was `Approved` or `Canceled`](https://github.com/paritytech/polkadot-sdk/blob/cfb29254f74412cea35e8048d8aea94bc789fcb1/substrate/frame/referenda/src/types.rs#L261).
+The submission deposit can be claimed by issuing the `refundSubmissionDeposit` extrinsic.
+
+Users can not refund their submission deposit while the referendum is `Ongoing` or `Rejected`.
+Similarly, users cannot refund their submission deposit if the proposal has `TimedOut` (failing to
+submit the decision deposit within a
 {{ polkadot: <RPC network="polkadot" path="const.referenda.undecidingTimeout" defaultValue={201600} filter="blocksToDays"/> :polkadot }}{{ kusama: <RPC network="kusama" path="const.referenda.undecidingTimeout" defaultValue={201600} filter="blocksToDays"/> :kusama }}-day
 period will lead to a referendum timeout). This behavior exists so that users can refrain from
 spamming the chain with proposals that have no interest from the community. If a proposal is in the

diff --git a/docs/learn/learn-guides-treasury.md b/docs/learn/learn-guides-treasury.md
@@ -104,18 +104,8 @@ 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.
-
-![Claim Preimage Deposit](../assets/claim-preimage-deposit.png)
-
-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 deposit and claim it.
-
-![Claim Referendum Deposits](../assets/claim-referendum-decision-deposit.png)
+The preimage and decision deposits
+[can be claimed once the referendum ends](./learn-guides-polkadot-opengov.md#claiming-the-preimage-and-decision-deposits).
 
 ## Requesting Tips from the Treasury
 
@@ -127,5 +117,15 @@ to the `32 / Small Spender` track, you will need to submit it to the `30 / Small
 Briefly, you will need to:
 
 - Create a preimage using the `treasury.Spend` extrinsic and specifying the number of tokens and the
-  beneficiary of the tip, and
-- Submit a proposal to the right track (i.e. `30` or `31`) using the preimage hash.
+  beneficiary of the tip
+- Submit a proposal to the right track (i.e. `30` or `31`) using the preimage hash
+- Once you started the referendum go to [Polkassembly](https://polkassembly.io/), log in with the
+  proposer account and edit the referendum details
+- Notify the
+  {{ polkadot: [Polkadot Direction Element Channel](https://matrix.to/#/#Polkadot-Direction:parity.io) :polkadot }}{{ kusama: [Kusama Direction Element Channel](https://matrix.to/#/#Polkadot-Direction:parity.io) :kusama }}
+  about your referendum
+- Place the decision deposit before the
+  {{ polkadot: <RPC network="polkadot" path="const.referenda.undecidingTimeout" defaultValue={201600} filter="blocksToDays"/> :polkadot }}{{ kusama: <RPC network="kusama" path="const.referenda.undecidingTimeout" defaultValue={201600} filter="blocksToDays"/> :kusama }}-day
+  timeout
+- Once the referendum ends you can
+  [claim the preimage and decision deposits back](./learn-guides-polkadot-opengov.md#claiming-the-preimage-and-decision-deposits)