polkadot-wiki icon indicating copy to clipboard operation
polkadot-wiki copied to clipboard

Migration of how-to guides for remaining Learn sections

Open keeganquigley opened this issue 2 years ago • 5 comments

  • [x] Find & identify necessary migrations for the remaining 4 Learn sections
  • [x] Settle on list of articles to migrate
  • [ ] Prepare (create/update) articles below
  • [ ] Remove/update corresponding wiki articles

There are 4 remaining Learn sections: Advanced Cryptography Paraobjects Polkadot Comparisons

We can split them up as follows:

@keeganquigley Advanced Cryptography

@michalisFr Paraobjects

@alineherzman Polkadot Comparisons

Articles to migrate

Advanced > Proxy Accounts: Create new article for setting up anon proxy. Include a warning about loss of funds, and use only UI screenshots.

Paraobjects > Parachains > Parachain Slots Auction: Create an article to briefly sum up how auctions work and include a video tutorial.

Polkadot Comparisons > Comparing Polkadot and Kusama: Create an article about Polkadot vs Kusama that summarizes the one in the wiki, and links to the more comprehensive one which will stay on the wiki.

keeganquigley avatar Aug 02 '22 21:08 keeganquigley

@keeganquigley I didn't find anything that warrants a migration in Paraobjects.

Parachain Crowdloans already links to the support article on how to contribute. Starting a Crowdloan Campaign is meant for parachain teams, so not suited for the support page. Withdraw Crowdloaned Tokens is also technical, and done by the parachain teams.

Perhaps we could create an article that's a simplified summary of how the auctions work that includes that nice video. It won't substitute any of the content on that wiki page though.

Teleporting Assets was already covered because it's a duplicated entry from Basics.

michalisFr avatar Aug 03 '22 12:08 michalisFr

Advanced - the only guide here that could possibly be migrated is how to create proxy accounts. @michalisFr Do you think it would be appropriate to create a basic article on setting proxies and link to the wiki? Or should we consider proxies as advanced and out of scope?

Cryptography - didn't find anything to migrate in here. We have existing article on how to properly store seeds which briefly explains the cryptography from a user perspective.

keeganquigley avatar Aug 03 '22 15:08 keeganquigley

From Polkadot Comparisons, maybe we can migrate the "Polkadot vs Kusama" part. It's not too technical.

I don't think comparing Polkadot to other projects belongs to the support page.

alineherzman avatar Aug 03 '22 16:08 alineherzman

@keeganquigley Yes, let's create an article for proxies and migrate the method that uses the UI.

For anonymous proxies let's create a separate article with a disclaimer that this is an advanced topic and a big warning that setting up an anonymous proxy incorrectly can result in loss of funds. Although it makes use of the extrinsics page (which we should avoid in the support page), it might become a more trending topic as more community members get interested in bounties. So, it's good to have a clear guide on how to set up an anon proxy on the support page.

@alineherzman Yes, let's create an article about Polkadot vs Kusama, that's a summary of the one in the wiki, but leave that one in the wiki too.

michalisFr avatar Aug 03 '22 16:08 michalisFr

Thanks @alineherzman and @michalisFr tasks have been updated.

keeganquigley avatar Aug 03 '22 20:08 keeganquigley

@alfarok @michalisFr articles have been updated and the last task is ready to be completed by the tech ed team. Thanks!

keeganquigley avatar Aug 25 '22 21:08 keeganquigley

This should be complete with the merging of #3715 and #3723 which are currently in review.

alfarok avatar Aug 29 '22 20:08 alfarok