Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Create plan for use of IPFS Camp content in ProtoSchool #261

Open
terichadbourne opened this issue Jul 11, 2019 · 4 comments

Comments

@terichadbourne
Copy link
Member

commented Jul 11, 2019

Review IPFS Camp content and determine what would fit well within ProtoSchool and whether it makes sense as new tutorials or additions to existing materials.

Related Issues:

  • #299 Link to CID Inspector from lessons where result is a CID
@terichadbourne

This comment has been minimized.

Copy link
Member Author

commented Aug 8, 2019

Adding a bit more detail to this one. :)

We plan to evaluate the content from IPFS Camp and see what would fit nicely into ProtoSchool in a variety of ways:

  • linking to camp content (videos when they're released, etc.) from resources pages in related ProtoSchool tutorials
  • incorporating some of the content / explanations / diagrams shared at camp into existing tutorials, such as the Decentralized Data Structures one which we plan to split in two or the MFS tutorial, both of which had relevant content shared in @alanshaw & @mikeal's core course
  • reformatting full workshops into their own new tutorials if we can find reasonable ways for them to fit our supported formats: text-only lessons, multiple-choice lessons, and in-browser JavaScript coding exercises using IPFS (with or without file upload)

If you have ideas on specific ways we could adapt IPFS Camp content into ProtoSchool, please share them in this issue!

@realChainLife

This comment has been minimized.

Copy link
Member

commented Aug 17, 2019

Hi Teri,

Great idea! I didn't get the chance to attend the IPFS Camp but going through the camp-content-first-batch release - there's a gold mine of content that i think would make great Protoschool tutorials.

At Protoschool Nairobi, we're taking ipfs enthusiasts through the tutorials as a weekly study guide and some of the content we can add to the course include:

  • The design of the IPFS Repo - A repo is the storage repository of an IPFS node. It is the subsystem that actually stores the data IPFS nodes use.

  • HTTP gateways - An IPFS Gateway acts as a bridge between traditional web browsers and IPFS.

Let me what you think and how I can hekp to get started with these if you agree.

@terichadbourne

This comment has been minimized.

Copy link
Member Author

commented Sep 5, 2019

@realChainLife Thank you so much for your offer to help with new content, and apologies for the delay in getting back to you! I'm still working my way through the camp content, but both of these topics you're proposing sound interesting and I'd love to hear more about what you have in mind!

I've been working on some clearer documentation for the process of building effective tutorials, not just how to build the tutorial in our repo (already documented here) but how to create great learning experiences and what features are supported by our platform. The easiest way to see my new additions (still very much a work in progress) is to check out the diff here. To get started, I'd recommend that you read through both sets of instructions linked above, check out the existing new tutorial proposals to see if there's any overlap, then open issues for each new tutorial proposal that doesn't already have an issue to add to. (Based on a quick glance through existing issues, I expect you'd be adding two new issues, one of each of your bulleted suggestions.)

If you spotted specific content from IPFS Camp (repo) that's relevant and could help inform either of these tutorials, you should definitely include links in your issue, along with links to any other helpful documentation that could be drawn on for the content. You'll see in the reference materials about building tutorials that there are a few different types of lessons available: code challenges (with or without file upload), text-only lessons, and multiple-choice lessons (new feature). I'd love to hear more in your issues about which formats you think would be most relevant for this content. We can use each issue as a place to solicit input from peers before you get started building and ensure there's a solid content outline that fits cohesively into the ProtoSchool curriculum and supports a beginner-friendly learning experience with appropriate scaffolding.

I'm really excited to learn more about the content you have in mind! 🎉 Please let me know if you have any questions about the documentation or would like to schedule some time to chat.

@terichadbourne

This comment has been minimized.

Copy link
Member Author

commented Sep 18, 2019

Core Course A: Understanding How IPFS Deals with Files (led by @alanshaw & @mikeal):

Potential uses in ProtoSchool:

  • New tutorial: Anatomy of a CID (including hashing details)
  • UX: Link to said new tutorial from the CID Inspector
  • UX: Link to CID Inspector from lessons where result is a CID (#299) - similar to what we now do with IPLD Explorer in DAG lessons
  • Tutorial improvement: Use some of the pics or images from the verifiability section in the location v content addressing portion of our Decentralized Data Structures tutorial, which we're planning to split in two
  • Tutorial improvement: Add lots of the content from the Merkle DAG section to the latter part of the Decentralized Data Structures tutorial, which we're planning to split in two
  • Tutorial improvement: Look at the MFS gotchas from the end of the talk and see what should be added to our MFS tutorial
  • Tutorial improvement: Link to the video from resources page in our MFS tutorial and Decentralized Data Structures tutorials
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
2 participants
You can’t perform that action at this time.