diff --git a/docs/assets/polkassembly-child-bounties.png b/docs/assets/polkassembly-child-bounties.png new file mode 100644 index 000000000000..a70fbca8a12f Binary files /dev/null and b/docs/assets/polkassembly-child-bounties.png differ diff --git a/docs/learn/learn-guides-bounties.md b/docs/learn/learn-guides-bounties.md new file mode 100644 index 000000000000..9ce1fdb3576d --- /dev/null +++ b/docs/learn/learn-guides-bounties.md @@ -0,0 +1,88 @@ +--- +id: learn-guides-bounties +title: How-to Guides for Bounties +sidebar_label: Bounties +description: Advanced How-to Guides for Bounties +keyword: [treasury, bounties, guides, child bounty] +slug: ../learn-guides-bounties +--- + +For these guides, you will use the [Polkadot-JS UI](https://polkadot.js.org/apps/#/explorer). + +:::info Notify the Polkadot Direction Channel + +Remember always to notify the +[Polkadot Direction Element Channel](https://matrix.to/#/#Polkadot-Direction:parity.io) about +[OpenGov referenda](./learn-polkadot-opengov.md#referenda) so that the community can start reviewing +them and voting on them. + +::: + +## Submit a Bounty Proposal + +See the video tutorial below to learn how you can create a bounty and submit it for approval through +an OpenGov referendum. + +[![Submit a Bounty](https://img.youtube.com/vi/8Cft1-8RWmk/0.jpg)](https://www.youtube.com/watch?v=8Cft1-8RWmk) + +When you add a bounty, this will show as "proposed" in the main +[Bounties page](https://polkadot.js.org/apps/#/bounties). Once the community approves your bounty +proposal as an OpenGov referendum, the bounty will show as "funded" at the end of the +[spending period](../general/glossary.md#spend-period) on the main +[Bounties page](https://polkadot.js.org/apps/#/bounties). You can then proceed with assigning +curators to the bounty. + +## Assign a Curator to a Bounty + +Once your bounty is shown as "funded" on the main +[Bounties page](https://polkadot.js.org/apps/#/bounties), you can propose a bounty curator. See the +video tutorial below to learn how you can add a curator to a bounty and submit it for approval +through an OpenGov referendum. + +[![Assign Curator to a Bounty](https://img.youtube.com/vi/TM7vk3oP9IA/0.jpg)](https://www.youtube.com/watch?v=TM7vk3oP9IA) + +Once your OpenGov referendum has been approved by the community and served the required +[spending period](../general/glossary.md#spend-period), the bounty will still show as "funded" on +the main [Bounties page](https://polkadot.js.org/apps/#/bounties) and await the curator's +acceptance. The curator must formally accept the curator role by signing a `bounties.acceptCurator` +extrinsic. More information about when to do this can be found on the main +[Bounties page](https://polkadot.js.org/apps/#/bounties). Only after the curators claim their +candidacy the bounty will show as "active" on the main Bounty page. + +## Create and Award Child Bounties + +:::info Remember to add contextual information about child bounties + +When you add child bounties, please add contextual information on the governance forums +[Polkassembly](https://polkassembly.io/) or [Subsquare](https://polkadot.subsquare.io/). + +::: + +See the video tutorial below to learn how to create a child bounty, assign a curator, and award a +child bounty. + +The video will show how to create and award a child bounty using a batch call. We will also include +proposing and approving curator candidacy for the child bounty. The calls can be executed +separately, depending on the process curators consider appropriate for their bounty. + +[![Create and Award Child Bounties](https://img.youtube.com/vi/mLpvx0OQoyM/0.jpg)](https://www.youtube.com/watch?v=mLpvx0OQoyM) + +Note that once a child bounty is awarded, awardees need to wait for the +{{ polkadot: 8 :polkadot }}{{ kusama: 4 :kusama }}-day delay to be complete before claiming the +child bounty. + +## Claim a Child Bounty Reward + +The status of child bounties can be viewed on the +[Polkassembly Bounty page](https://polkadot.polkassembly.io/bounties) under the specific parent +bounty. A child bounty status can be "Added", "Awarded", or "Claimed". For example, the parent +bounty 17 refers to the Community Events Bounty, which has 183 child bounties. + +![polkassembly-child-bounties](../assets/polkassembly-child-bounties.png) + +After a child bounty has been awarded and the {{ polkadot: 8 :polkadot }}{{ kusama: 4 :kusama }}-day +delay elapsed, follow the guidelines in the video tutorial below to learn how to claim a child +bounty reward. Note that the extrinsic to claim the child bounty reward is permissionless, and +anyone can initiate the claim on behalf of the beneficiary. + +[![Claim Child Bounty Reward](https://img.youtube.com/vi/db82aHgy23c/0.jpg)](https://www.youtube.com/watch?v=db82aHgy23c) diff --git a/docs/learn/learn-guides-polkadot-opengov.md b/docs/learn/learn-guides-polkadot-opengov.md index 223b668fbe71..21b6e476c282 100644 --- a/docs/learn/learn-guides-polkadot-opengov.md +++ b/docs/learn/learn-guides-polkadot-opengov.md @@ -27,11 +27,11 @@ attain ::: -To cancel a referendum, you need first to submit a preimage with the `referenda.cancel` extrinsic. Go to the -[Polkadot-JS UI > Governance > Referenda](https://polkadot.js.org/apps/#/referenda) and click on the -"Add Preimage" button. You must specify -the `referenda.cancel` extrinsic with the index equal to the ongoing Referendum you wish to cancel. -In the screenshot below, the Referendum to be cancelled is 249. +To cancel a referendum, you need first to submit a preimage with the `referenda.cancel` extrinsic. +Go to the [Polkadot-JS UI > Governance > Referenda](https://polkadot.js.org/apps/#/referenda) and +click on the "Add Preimage" button. You must specify the `referenda.cancel` extrinsic with the index +equal to the ongoing Referendum you wish to cancel. In the screenshot below, the Referendum to be +cancelled is 249. ![cancel-referenda-preimage-creation](../assets/cancel-referenda-preimage-creation.png) diff --git a/docs/learn/learn-polkadot-opengov.md b/docs/learn/learn-polkadot-opengov.md index 594571d2e112..8681e24c6468 100644 --- a/docs/learn/learn-polkadot-opengov.md +++ b/docs/learn/learn-polkadot-opengov.md @@ -645,9 +645,9 @@ For more information about how to submit a whitelisted proposal see the ### Becoming a Polkadot Technical Fellowship Member -Currently, the only way to become a fellowship member is through a referenda. To get added as a -member of "Rank 1", an existing member of the fellowship needs to submit a referendum with the preimage of a -batch call that has `fellowshipCollective.addMember` and +Currently, the only way to become a fellowship member is through a referenda. To get added as a +member of "Rank 1", an existing member of the fellowship needs to submit a referendum with the +preimage of a batch call that has `fellowshipCollective.addMember` and `fellowshipCollective.promoteMember` on "2/Proficients" track. On Polkadot-JS UI for Polkadot Collectives, navigate to Governance > Fellowship > Referenda and click on "Add Preimage". This preimage can be submitted by anyone. diff --git a/docs/learn/learn-proxies-pure.md b/docs/learn/learn-proxies-pure.md index 1e04703902e9..f9362e56049f 100644 --- a/docs/learn/learn-proxies-pure.md +++ b/docs/learn/learn-proxies-pure.md @@ -239,9 +239,11 @@ and then the old multisig can be removed as a proxy. ![multisig with pure](../assets/multisig-with-pure.png) Compared to [Scenario Two](#scenario-two-multisig-made-of-pure-proxies), signatories do not need to -create pure proxies here. Multisig controlling a Pure Proxy is a more practical solution, where the signatories, number of signatories and/or the threshold can be changed, which changes the multisig address but does not impact the pure proxy address. In Scenario Two, if signatories behind the pure proxies change, -the address of the multisig stays the same. However, changing the number of signatories and -threshold would not be possible. +create pure proxies here. Multisig controlling a Pure Proxy is a more practical solution, where the +signatories, number of signatories and/or the threshold can be changed, which changes the multisig +address but does not impact the pure proxy address. In Scenario Two, if signatories behind the pure +proxies change, the address of the multisig stays the same. However, changing the number of +signatories and threshold would not be possible. ## Proxy calls diff --git a/polkadot-wiki/sidebars.js b/polkadot-wiki/sidebars.js index 159376072377..f5705462a837 100644 --- a/polkadot-wiki/sidebars.js +++ b/polkadot-wiki/sidebars.js @@ -287,6 +287,7 @@ module.exports = { }, "learn/learn-guides-polkadot-opengov", "learn/learn-guides-treasury", + "learn/learn-guides-bounties", "learn/learn-guides-identity", { type: "category",