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

ProtoSchool presentation resources #58

Closed
1 of 3 tasks
momack2 opened this issue Sep 2, 2019 · 12 comments
Closed
1 of 3 tasks

ProtoSchool presentation resources #58

momack2 opened this issue Sep 2, 2019 · 12 comments

Comments

@momack2
Copy link
Contributor

momack2 commented Sep 2, 2019

At Web3, some ProtoSchool organizers (@kk3wong and @onion797jp) requested a nice slides template to use when leading protoschool meetups. I know there's already a draft one here that @akrych made. What is remaining to launch that for everyone to use?

I think it'd also be nice to provide:

  • A template "what is IPFS" deck with images/diagrams and speaker notes
  • A template "what is libp2p" deck with images/diagrams and speaker notes
  • Facilitator guides (with presentations, images, and exercises) to augment some of the workshops (ex - demonstrating examples in http://cid.ipfs.io and http://dag.ipfs.io as part of facilitating https://proto.school/#/data-structures)

Do folks have other ideas / requests that would help them run awesome protoschool chapters?

@terichadbourne
Copy link
Member

terichadbourne commented Sep 6, 2019

Thanks for documenting these suggestions @momack2!

@nukemandan & I discussed this a bit yesterday, and would propose the following. (Please let us know if any of these approaches don't sound like they'd meet your needs, or if you have suggestions for improvement.)

A)

a nice slides template to use when leading protoschool meetups

The reason I haven't shared the draft slide template with chapter organizers yet is due to an accessibility concern I have regarding color contrast. I've chatted briefly with @ericronne while @akrych is on vacation, and will follow up with Agata when she's back to see if we can get that tweaked and then shared in our assets folder here in the organizing repo.

B)

A template "what is IPFS" deck with images/diagrams and speaker notes

Although ProtoSchool only contains IPFS content at present, I want to lay the groundwork for a system that lets us offer resources in the right places across multiple projects and takes advantage of where the most eyeballs are at present. Some ProtoSchool chapter leaders are presenting exclusively our tutorial content (from our website) at their local events, and others are supplementing with additional presentations in other formats on related topics. I think it would be great to have presos that are specifically about IPFS or LibP2P and not inherently related to ProtoSchool live in a place where the broader communities for each project can find and utilize them. So for example, there might be a folder of shareable presentation decks that we would store somewhere in the ipfs/community repo, with a single point of official hosting so as to avoid making updates in multiple places. There are more eyes on that repo and a broader audience that includes IPFS Meetup leaders who aren't hosting ProtoSchool workshops. We'd then link to those resources from the ProtoSchool organizing repo. The one caveat here is branding, as we might want IPFS templates for broader use but could also provide an equivalent deck in the ProtoSchool pallette.)

C)

A template "what is libp2p" deck with images/diagrams and speaker notes

Same concept as above but hosted in a relevant libp2p repo.

D)

Facilitator guides (with presentations, images, and exercises) to augment some of the workshops (ex - demonstrating examples in http://cid.ipfs.io and http://dag.ipfs.io as part of facilitating https://proto.school/#/data-structures)

These resources, by contrast, being directly associated with ProtoSchool content, are ones I'd envision living here in the organizing repo. (We'd link from the ipfs/community repo to ProtoSchool to make folks aware that they exist.) I do really like the idea of offering instructional guides or supplementary materials for specific tutorials taught at live events. However, I'd caution that we need to watch out for our online users as well.... If we find a diagram or resource that enhances a topic we should also consider adding it to the website when that makes sense. We're already reviewing IPFS Camp content for great resources like these to add into our site in multiple ways:

  • Images are already supported in lessons themselves
  • Resources pages allow us to link to cool external resources at the end of each tutorial
  • It would be cool to find ways to integrate those new visualization tools (http://cid.ipfs.io and http://dag.ipfs.io) as part of existing lessons, perhaps in the way you can current view your results in the DAG Explorer.
    image

As a reminder, everyone should feel free to suggest specific improvements to existing lessons or tutorials, propose new tutorials, or propose new features, using the appropriate issue templates in our website repo.

E)
Facilitation best practices for teaching ProtoSchool tutorials as live workshops
Although not yet mentioned in this issue, @momack2 and I have also talked about providing resources to help folks understand best practices for teaching a ProtoSchool tutorial in a live face-to-face environment. It's important to point out that this is not a request about teaching a specific tutorial (addressed above), nor about how to run a ProtoSchool chapter with multiple events over time, nor about how to teach other formats of content; it's just about turning the tutorials on our website into effective live experiences. (The scope would be narrower than the scope of the awesome community session from IPFS Camp The suggestions I'm envisioning here would apply equally to folks who are leading longstanding ProtoSchool chapters and those who would like to run a live ProtoSchool workshop as a one-off at another event with a dweb connection, as happened at Web3. These tips would cover issues such as:

  • How to run a ProtoSchool workshop
  • When to run one
  • Which one you should choose based on your audience
  • How skilled you have to be
  • Facilitation best practices
  • Ratio of guests to trainers
  • Who does what on site
  • How to encourage attendees to submit feedback on the tutorials via GitHub issues
  • FAQs
  • Anything you should bring, provide, print out, etc.

How to accomplish all of this
There are lots of great ideas here for community members to take the lead on!

I'll volunteer to coordinate getting Item A (slide deck tweaks and sharing) done, with the timing dependent on the workload of my awesome design pals.

To the extent they are available and willing, I think it would be fabulous to have the folks who've already been leading ProtoSchool chapters or workshops take the lead on Items D & E (instructional guides for specific tutorials and a more generic workshop facilitation guide), opening issues for any related website changes if ideas arise during the process.

Items B & C (intro slide decks for IPFS & libp2p) could be created (or adapted from lots of great presos that already exist) by any volunteers familiar with the subject matter.

@nukemandan has offered to help with some of the facilitation materials or slide decks but won't have availability until mid-October, so would be shooting for an Oct 21 goal for a first draft. Now that this is all laid out more visually I'll let him comment on specifically which pieces he feels most able to take on. ;)

@kk3wong we weren't able to catch you for our chat but would be very interested in your help with any of these items you're interested in helping with, as well as your feedback on the overall plan.

@momack2 and @onion797jp Are either of you excited about creating any of these materials yourselves?

Once we have feedback and clear volunteers assigned, I'm happy to take on the task of separating this issue out into bite-sized chunks for each project.

@terichadbourne
Copy link
Member

@nukemandan @kk3wong As we work on Q4 OKRs for ProtoSchool, could you please check out the list of proposals above and let us know which you'd each enjoy taking the lead on and what timelines would feel reasonable given your other commitments? Thanks!

@nuke-web3
Copy link
Contributor

nuke-web3 commented Sep 19, 2019

@terichadbourne - I can look by the end of this month as what October has time wise for me 😁

@momack2
Copy link
Contributor Author

momack2 commented Oct 10, 2019

Steven gave a really great "what is IPFS" presentation at the Osaka IPFS meetup last weekend that I'd love to turn into a first draft of a broader community resource. Happy to take DRI for cleaning that up and putting in the ipfs/community repo along with a video from the meetup so would-be presenters can see an exemplar. Would love to see a number of these things land in a ProtoSchool-promoting bundle this quarter!

@terichadbourne
Copy link
Member

That sounds great, @momack2. Thanks for volunteering to take the lead on that! (DRI = Directly Responsible Individual, for those unfamiliar with our lingo. 🤓)

@nukemandan & @kk3wong have you had a chance to scan the description of the requested resources (in this comment) and see if any of them are in your wheelhouse and manageable with your workload this quarter? Item E is listed as the most critical in the community section of our Q4 OKRs and also one that the two of you would be super well suited for, as it's related to a portion of what you covered in your IPFS Camp course.

Priority Resource Owner
P0 Facilitation best practices for teaching ProtoSchool tutorials as live workshops (E) TBC
P1 ProtoSchool slide template (A) @terichadbourne
P2 "What is IPFS" slide deck (B) @momack2
P2 Facilitator guides to augment some of the ProtoSchool workshops (D) TBC
P3 "What is libp2p" slide deck (C) TBC

@momack2
Copy link
Contributor Author

momack2 commented Oct 18, 2019

I took a quick pass at adding some general "what is IPFS" content to @Stebalien's amazing "How does IPFS work" presentation from the Japan Protoschool meetups: https://docs.google.com/presentation/d/1wyrTNTERJV23R7PyLrNloBauygdq1SXerijvEUG62xI/edit

Feedback welcome on the overall flow! It still needs full speakers notes and a accompanying recording of Steven talking through it.

@terichadbourne
Copy link
Member

This is awesome @momack2, thank you! I agree that more speaker notes would be helpful, and I love the idea of also providing a recording of @Stebalien so presenters can feel even more prepared before delivering it themselves.

@terichadbourne
Copy link
Member

terichadbourne commented Nov 4, 2019

@momack2 @nukemandan @kk3wong I'm working on updating the ProtoSchool Q4 OKRs with estimates of how far we expect to get on various tasks this quarter.

@momack2 Does finishing up the edits to @Stebalien's preso (mostly speaker notes, I think) feel like it's within your bandwidth this quarter? Shall I mark that as a 0.8 done / 1.0 estimated?

@nukemandan @kk3wong Just checking in again to see if you have the time and interest to tackle any of the unassigned tasks below this quarter. The one that would be top priority in my opinion, if you're game, would be adapting some of the work you put into your IPFS Camp preso to create a written guide to facilitating a ProtoSchool tutorial as a live workshop (without the context of running a chapter over time, just thinking about the single event).

Priority Resource Owner Issue Done
P0 Facilitation best practices for teaching ProtoSchool tutorials as live workshops (E) @nukemandan #75
P1 ProtoSchool slide template (A) @terichadbourne #62
P2 "What is IPFS" slide deck (B) @momack2 #63
P2 Facilitator guides to augment some of the ProtoSchool workshops (D) TBC
P3 "What is libp2p" slide deck (C) TBC

@terichadbourne
Copy link
Member

Thanks to @momack2 for pulling together some IPFS slide decks and adding them to the community repo here: https://github.com/ipfs/community#ipfs-event-materials 🎉

I'm currently chatting with the libp2p team about the possibility of doing something similar, to include this intro deck from Raul: https://github.com/raulk/talks/blob/master/libp2p%20-%20Crosslink%2719%20-%20Introduction%20to%20libp2p%20(Taipei%2C%202019-10-20).pdf

@terichadbourne
Copy link
Member

I've added a section to our resources page that we can use to link out to educational materials for specific projects, including the two items mentioned above. I'll also create an issue announcement for chapter leaders once we've made the tweaks we want to the IPFS listing and found a more permanent home for libp2p.

@terichadbourne
Copy link
Member

I’ve added a section to RESOURCES.md with links to ProtoSchool-branded slide deck templates.

@terichadbourne
Copy link
Member

Closing this one as the suggestions are now tracked in individual issues.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants