ProtoSchool / protoschool.github.io

The code that runs the ProtoSchool website. Visit https://proto.school for interactive tutorials on decentralized web protocols. Explore IPFS and Filecoin through code challenges, code-free lessons, and local events.
https://proto.school
Other
165 stars 67 forks source link

MFS - Lesson 1 (Introducing IPFS) - very text-heavy! #237

Open Frijol opened 5 years ago

Frijol commented 5 years ago

URL of the lesson that's confusing: https://proto.school/#/mutable-file-system/01

What's confusing about this lesson?

This is very dense! Between the technical terms (file system, P2P, IPFS, CID) and the tombstone text, it is really hard to not just scroll down the page after the first sentence or two and click to see what's next.

What additional context could we provide to help you succeed?

Is there any way you can share this information in non-text (and ideally interactive) forms? Otherwise I think you're going to get very few people actually reading this!

Ideas for breaking up the text/ getting people to engage:

But maybe the difficulty with this page runs deeper than that. The first two sections are mostly there as review from other tutorials, right? You have to have your readers understand them before they can understand MFS. But you could just list other tutorials as prereqs.

Overall there's so much dense information on this page that I'm not sure what I'm supposed to learn from it.

What other feedback would you like to share about ProtoSchool?

Frijol commented 5 years ago

The "Mutable File System" section is actually very clear by itself– are the other two sections needed?