Refactor the tutorial to be more friendly
Opened this issue ยท 0 comments
shawntabrizi commented
At the moment, the tutorial is a pretty large dump of my knowledge into text form.
This is not great, because it can be too verbose and unapproachable for people who are very new to polkadot-sdk
.
I would like to refactor the code to have 3 levels of approachability:
- Basic - Someone who just wants to learn the bare bones basics needed to get through the tutorial. I consider this to be mostly a mechanical understanding of the tutorial. This should be the content at the top of the documentation, and first to access.
- Intermediate - Someone who wants to learn everything the tutorial has to offer. This content should maybe be hidden behind an accordion. Nothing in this content should be required to complete the tutorial. The content should be relevant for the tasks we are doing, but perhaps goes into other kinds of details beyond the scope of the tutorial itself.
- Advance - Mostly content NOT included in this tutorial, but linked to or referenced. This could be links to other repos, embedded videos, other documentation, etc... This should usually just be its own section "Learn More", with a minimal summary of what content we are pointing to. Perhaps just a sentence. Really this is releasing the student to the wild.
ADDITIONALLY, with the Basic content, we should be looking to add graphics or emojis throughout the tutorial to make it more "fun" to read.
๐ฑ ๐ธ ๐น ๐ ๐โโฌ