From c859cc8aeac56132aa80047cb159751783d0209d Mon Sep 17 00:00:00 2001 From: Alison Dowdney Date: Mon, 10 May 2021 20:37:55 +0100 Subject: Rename new contributor workshop to contributor workshop --- .../2020/03-contributor-summit/README.md | 13 ++ .../2020/03-contributor-summit/content-proposal.md | 165 +++++++++++++++++++++ .../2020/03-contributor-summit/runbook.md | 160 ++++++++++++++++++++ mentoring/programs/contributor-workshop/OWNERS | 17 +++ mentoring/programs/contributor-workshop/README.md | 8 + .../contributor-workshop/resources/README.md | 40 +++++ .../resources/build-and-test.md | 27 ++++ .../resources/community-groups.md | 27 ++++ .../resources/contributor-paths.md | 26 ++++ .../resources/first-issue-help.md | 31 ++++ .../resources/how-we-communicate.md | 33 +++++ .../resources/labels-and-bots.md | 25 ++++ .../contributor-workshop/resources/live-pr-demo.md | 24 +++ .../resources/new-contributor-workshop-lead.md | 54 +++++++ .../resources/playground-exercise.md | 28 ++++ .../contributor-workshop/resources/repo-tour.md | 24 +++ .../resources/workspace-setup.md | 24 +++ .../programs/contributor-workshop/videoguide.md | 131 ++++++++++++++++ .../2020/03-contributor-summit/README.md | 13 -- .../2020/03-contributor-summit/content-proposal.md | 165 --------------------- .../2020/03-contributor-summit/runbook.md | 160 -------------------- mentoring/programs/new-contributor-workshop/OWNERS | 17 --- .../programs/new-contributor-workshop/README.md | 8 - .../new-contributor-workshop/resources/README.md | 40 ----- .../resources/build-and-test.md | 27 ---- .../resources/community-groups.md | 27 ---- .../resources/contributor-paths.md | 26 ---- .../resources/first-issue-help.md | 31 ---- .../resources/how-we-communicate.md | 33 ----- .../resources/labels-and-bots.md | 25 ---- .../resources/live-pr-demo.md | 24 --- .../resources/new-contributor-workshop-lead.md | 54 ------- .../resources/playground-exercise.md | 28 ---- .../resources/repo-tour.md | 24 --- .../resources/workspace-setup.md | 24 --- .../new-contributor-workshop/videoguide.md | 131 ---------------- 36 files changed, 857 insertions(+), 857 deletions(-) create mode 100644 mentoring/programs/contributor-workshop/2020/03-contributor-summit/README.md create mode 100644 mentoring/programs/contributor-workshop/2020/03-contributor-summit/content-proposal.md create mode 100644 mentoring/programs/contributor-workshop/2020/03-contributor-summit/runbook.md create mode 100644 mentoring/programs/contributor-workshop/OWNERS create mode 100644 mentoring/programs/contributor-workshop/README.md create mode 100644 mentoring/programs/contributor-workshop/resources/README.md create mode 100644 mentoring/programs/contributor-workshop/resources/build-and-test.md create mode 100644 mentoring/programs/contributor-workshop/resources/community-groups.md create mode 100644 mentoring/programs/contributor-workshop/resources/contributor-paths.md create mode 100644 mentoring/programs/contributor-workshop/resources/first-issue-help.md create mode 100644 mentoring/programs/contributor-workshop/resources/how-we-communicate.md create mode 100644 mentoring/programs/contributor-workshop/resources/labels-and-bots.md create mode 100644 mentoring/programs/contributor-workshop/resources/live-pr-demo.md create mode 100644 mentoring/programs/contributor-workshop/resources/new-contributor-workshop-lead.md create mode 100644 mentoring/programs/contributor-workshop/resources/playground-exercise.md create mode 100644 mentoring/programs/contributor-workshop/resources/repo-tour.md create mode 100644 mentoring/programs/contributor-workshop/resources/workspace-setup.md create mode 100644 mentoring/programs/contributor-workshop/videoguide.md delete mode 100644 mentoring/programs/new-contributor-workshop/2020/03-contributor-summit/README.md delete mode 100644 mentoring/programs/new-contributor-workshop/2020/03-contributor-summit/content-proposal.md delete mode 100644 mentoring/programs/new-contributor-workshop/2020/03-contributor-summit/runbook.md delete mode 100644 mentoring/programs/new-contributor-workshop/OWNERS delete mode 100644 mentoring/programs/new-contributor-workshop/README.md delete mode 100644 mentoring/programs/new-contributor-workshop/resources/README.md delete mode 100644 mentoring/programs/new-contributor-workshop/resources/build-and-test.md delete mode 100644 mentoring/programs/new-contributor-workshop/resources/community-groups.md delete mode 100644 mentoring/programs/new-contributor-workshop/resources/contributor-paths.md delete mode 100644 mentoring/programs/new-contributor-workshop/resources/first-issue-help.md delete mode 100644 mentoring/programs/new-contributor-workshop/resources/how-we-communicate.md delete mode 100644 mentoring/programs/new-contributor-workshop/resources/labels-and-bots.md delete mode 100644 mentoring/programs/new-contributor-workshop/resources/live-pr-demo.md delete mode 100644 mentoring/programs/new-contributor-workshop/resources/new-contributor-workshop-lead.md delete mode 100644 mentoring/programs/new-contributor-workshop/resources/playground-exercise.md delete mode 100644 mentoring/programs/new-contributor-workshop/resources/repo-tour.md delete mode 100644 mentoring/programs/new-contributor-workshop/resources/workspace-setup.md delete mode 100644 mentoring/programs/new-contributor-workshop/videoguide.md (limited to 'mentoring/programs') diff --git a/mentoring/programs/contributor-workshop/2020/03-contributor-summit/README.md b/mentoring/programs/contributor-workshop/2020/03-contributor-summit/README.md new file mode 100644 index 00000000..283fe402 --- /dev/null +++ b/mentoring/programs/contributor-workshop/2020/03-contributor-summit/README.md @@ -0,0 +1,13 @@ +## NCW Workshop Amsterdam + +## Team + +| Name & Handle | Role | Timezone | +|---------------|------|----------| +| | | | +| | | | +| | | | + +## Deadlines + +## Meeting Information diff --git a/mentoring/programs/contributor-workshop/2020/03-contributor-summit/content-proposal.md b/mentoring/programs/contributor-workshop/2020/03-contributor-summit/content-proposal.md new file mode 100644 index 00000000..93ea95d3 --- /dev/null +++ b/mentoring/programs/contributor-workshop/2020/03-contributor-summit/content-proposal.md @@ -0,0 +1,165 @@ +# Content Proposal for NCW Amsterdam + +## Introduction + +### 9:30 - 11:00 Intro Communications and Community +Alison, Rob, Rael, Josh: support/segment? + +Provide an overview on how the community works as a project both in terms of coordinating people and the special interest groups that those people participate in and the workflow that are used to accept new features, bug fixes. + +Note: Although these will have to be run separately, the content will be the same. + +## NCW Topics 101 + +This workshop will help a complete newcomer to Kubernetes get a running start as a contributor. Learn how to set up your developer environment, how to find your first contribution, and how to navigate the Kubernetes GitHub workflow. We will focus on a community approach to solving challenges, and on being good open source citizens. + +### Morning Session + +#### 11:00 - 12:00 [Workspace Setup](https://github.com/kubernetes/community/blob/master/events/events-team/content/new-contributor-workshops/workspace-setup.md) Tim & Rael + +Make sure all Beginning Contributors have a workspace setup for hacking on Kubernetes + +#### 12:00 - 12:30 [Local Build Test](https://github.com/kubernetes/community/blob/master/events/events-team/content/new-contributor-workshops/build-and-test.md) Tim & Rael +#### 13:30 - 14:00 [Local Build Test](https://github.com/kubernetes/community/blob/master/events/events-team/content/new-contributor-workshops/build-and-test.md) Tim & Rael + +Build Kubernetes binaries locally, and do some fun things with them. + +### Afternoon Sessions + +#### 14:00 - 14:45 [Pull Request Exercise](https://github.com/kubernetes/community/blob/master/events/events-team/content/new-contributor-workshops/playground-exercise.md) Guinevere, Rob + +Give new contributors the experience of the Kubernetes GitHub workflow! + +This task requires some setup and planning. Labels, Bots + +#### 14:45 - 15:15 [Find Your First Issue](https://github.com/kubernetes/community/blob/master/events/events-team/content/new-contributor-workshops/first-issue-help.md) Jeff + +Set participants on as much of a paved path to contributor success as possible. At this point in the workshop, participants should know what kind of issue they want to tackle. + +## NCW Topics 201 + +This workshop focuses on the **more experienced** open source contributor. You may have sent patches to Kubernetes before, but may have gotten stuck or overwhelmed somewhere along the line. Take your contributor journey to the next level by learning about the main Kubernetes code base, how to build and test Kubernetes, and how to find reviewers and collaborators for your issue patches. + +### Morning Session + +#### 11:00 - 12:00 K/K Walkthrough Alison + +Alison + +Guided tour of the main k/k repository, to build a broader understanding of how the codebase is structured + +#### 12:00 - 12:25 Labels, Bots and Git Workflow Guin & Rob + +In this session, we will cover how contributors interact with the kubernetes codebase on github. Join us as we dive into the Git Workflow used throughout the kubernetes project, including how Labels and Bots play a key role in managing issues and prs. + +### Afternoon Sessions + +#### 13:30 - 14:30 [Local Build & Test](https://github.com/kubernetes/community/blob/master/events/events-team/content/new-contributor-workshops/build-and-test.md) - 1hour ( Or Maybe More? ) Ben + +Build Kubernetes binaries locally, and do some fun things with them. + +#### 14:30 - 14:50 You! Yes you can review a PR! 15-20m Alison & Tim H + +In this session attendees will learn the in’s and outs of reviewing pull requests. We will go through a reviewing a pull request onstage, and provide some good starting points. + +#### 14:50 - 15:15 [Finding Your First Issue](https://github.com/kubernetes/community/blob/master/events/events-team/content/new-contributor-workshops/first-issue-help.md) / Closing Remarks 15m + +To close the Intermediate contributor workshop, The intermediate contributor workshop team will share their tips and tricks of finding a first issue, and stories of their first contributions. + +## Resources To Create + +* Capture who is presenting what + +* Slides to reflect the content proposal + +* Assign presenters for each section so presenters own their own slides + +* Docker Image Registry + + * Source Tree in a Docker Image incase of networking issues + + * [Sheet of what will be on the Harbor box](https://docs.google.com/spreadsheets/d/1_CUFluzIgeHt4vra9hs6OqBqDZQ8oUl9Og-IixkoEAM/edit?usp=sharing) + + * Add the needed container images, other binaries you want, and specific versions + +* Know before you go details + + * Instructions, What to install on your laptop, Sign the CLA + +* Can we link and update the handbooks here? Every presenter can update the handbooks as content matures! + +* On the day plan - More indepth dive of what happens + +### On The Day / Extra Notes +[runbook.md](runbook.md) + +### Handbooks +[../resources](../resources) + +### Slides +[https://docs.google.com/presentation/d/19OtCzuDTVeeIfMD39OOODGJzkV3UGM_nr7jpSNhoy2s/edit?ts=5e4b8bc8#slide=id.g52cc57d172_7_69](https://docs.google.com/presentation/d/19OtCzuDTVeeIfMD39OOODGJzkV3UGM_nr7jpSNhoy2s/edit?ts=5e4b8bc8#slide=id.g52cc57d172_7_69) + +## Slide Ideas + +* Solidify formatting for each type of slide + + * Code with instructions + + * Main Image + + * Image with text + + * Title Slides + + * Schedule Slides + +* Retro notes - Be a bit more creative with the slides, Do we want to do a direct copy paste of the slides from last time + +* From San Diego page +*Try to represent the journey of a contributor with the slides* + +* *Linking the key ideas themes, with walking along a brick road or similar. From cat to kubecat. *Or capybara to kubeybara + +* Break Slides + +* *Is a long presentation, adding a timeline at the bottom can help the attendees follow the presentation. This can go with the idea of showing the progress of the contributor as we move forward with the presentation. - I love this! -guin* + +## References + +San Diego Contributor Summit Content Proposal + +[https://docs.google.com/document/d/1ha3KtgLcRIY7IaRi9pm_h28xVsx9VoVLu8Fl1YO-eCI/edit?pli=1#heading=h.c2mvd8re7lpn](https://docs.google.com/document/d/1ha3KtgLcRIY7IaRi9pm_h28xVsx9VoVLu8Fl1YO-eCI/edit?pli=1#heading=h.c2mvd8re7lpn) + +Last years sched for san diego + +[https://kcsna2019.sched.com/](https://kcsna2019.sched.com/) + +Reference + +[https://github.com/kubernetes/community/blob/master/events/events-team/content/new-contributor-workshops/README.md](https://github.com/kubernetes/community/blob/master/events/events-team/content/new-contributor-workshops/README.md) + +## Virtual Event Go/No Go + +Alison: Go (speaking live) + +Jeff: Go (streaming/speaking live) + +Josh: Go (pre-record; virtual Q&A) + +Guin: Go (pre-record) + +James M: + +Rob: Go (Flexible; assign content ASAP) + +Chris Short: Go (shadow; streaming) + +Samudrala: Can present + +Nabarun: Can present + +Tim P: Can present (shadow) + +Rael: No Go + +Ben: No Go diff --git a/mentoring/programs/contributor-workshop/2020/03-contributor-summit/runbook.md b/mentoring/programs/contributor-workshop/2020/03-contributor-summit/runbook.md new file mode 100644 index 00000000..57369a71 --- /dev/null +++ b/mentoring/programs/contributor-workshop/2020/03-contributor-summit/runbook.md @@ -0,0 +1,160 @@ +# NCW On The Day Runbook / Extra Notes + +### 9:30 - 11:00 Intro Communications and Community +Alison, Rob, Rael, Josh: support/segment? + +Sections + +* Welcome & PR Demo [Slide 6](https://docs.google.com/presentation/d/19OtCzuDTVeeIfMD39OOODGJzkV3UGM_nr7jpSNhoy2s/edit#slide=id.g64b51f6423_1_0) + +* Why Contribute / Origin Story [Slide 10](https://docs.google.com/presentation/d/19OtCzuDTVeeIfMD39OOODGJzkV3UGM_nr7jpSNhoy2s/edit#slide=id.g5e6254b17b_4_1168) + + * Why + + * Origin Story + + * Choose your adventure + + * Find your topic + +* Communications [Slide 13](https://docs.google.com/presentation/d/19OtCzuDTVeeIfMD39OOODGJzkV3UGM_nr7jpSNhoy2s/edit#slide=id.g5e6254b17b_4_1185) + + * How we communicate + + * Standards + + * Asking tech Q’s + +* Community Groups/Organization/SIG Tour: Josh? [Slide 29](https://docs.google.com/presentation/d/19OtCzuDTVeeIfMD39OOODGJzkV3UGM_nr7jpSNhoy2s/edit#slide=id.g5e6254b17b_4_1266) + +* Repo Tour: Samudrala [Slide 52](https://docs.google.com/presentation/d/19OtCzuDTVeeIfMD39OOODGJzkV3UGM_nr7jpSNhoy2s/edit#slide=id.g645f82e308_0_17) + +* How to find what you need: Alison [Slide 55](https://docs.google.com/presentation/d/19OtCzuDTVeeIfMD39OOODGJzkV3UGM_nr7jpSNhoy2s/edit#slide=id.g7eae03886b_2_18) + + * https://cs.k8s.io/ + +Josh: I can take any of the above that someone else doesn't want. + +#### Notes and cool ideas + +#### Communications Tools + +Discuss, Slack, Mailing List, Github, Twitter + +#### Kubernetes Podcasts + +#### Periodic Meetings + +Office Hours, Community Meeting + +#### Scavenger Hunt + +Register in k8s slack, post a Hi to the New Contributor Workshop Room + +Post a commit made by Joe Beda that contains a TODO to a special NCW Amsterdam discuss Thread. Oldest TODO wins. + +Find and favorite a NCW Easter Egg post in the NCW Amsterdam room + +Find and heart a k8s First Good Issue on Github + +#### +Main content + +Live PR Demo + +Paths to Contributorship + +Communication in the Kubernetes Community + +Community Group and Governance + +Orgs Overview + +How to find what you need in the community + +Tips and tricks to interact with the community +Teach people to answer their own questions + +[cs.k8s.io](https://cs.k8s.io/) + +How to phrase questions + +Limitations of GitHub searches + +Traversing K8s docs + +List speakers and roles for each section + +## NCW Topics 101 + +### 11:00 - 12:00 [Workspace Setup](https://github.com/kubernetes/community/blob/master/events/events-team/content/new-contributor-workshops/workspace-setup.md) Tim & Rael + +**Make sure all Beginning Contributors have a workspace setup for hacking on Kubernetes** + +### 12:00 - 12:30 [Local Build Test](https://github.com/kubernetes/community/blob/master/events/events-team/content/new-contributor-workshops/build-and-test.md) Tim & Rael + +### 13:30 - 14:00 [Local Build Test](https://github.com/kubernetes/community/blob/master/events/events-team/content/new-contributor-workshops/build-and-test.md) **Tim & Rael** + +**Build Kubernetes binaries locally, and do some fun things with them.** + +### 14:00 - 14:45 [Pull Request Exercise](https://github.com/kubernetes/community/blob/master/events/events-team/content/new-contributor-workshops/playground-exercise.md) **Guinevere, Rob** + +**Give new contributors the experience of the Kubernetes GitHub workflow! ** + +**This task requires some setup and planning. Labels, Bots** + +### 14:45 - 15:15 [Find Your First Issue](https://github.com/kubernetes/community/blob/master/events/events-team/content/new-contributor-workshops/first-issue-help.md) **Jeff** + +Set participants on as much of a paved path to contributor success as possible. At this point in the workshop, participants should know what kind of issue they want to tackle. + +## NCW Topics 201 + +### Morning Session + +### K/K Walkthrough 11:00 - 12:00 + +Alison + +Guided tour of the main k/k repository, to build a broader understanding of how the codebase is structured + +### Labels, Bots and Git Workflow 12:00 - 12:25 + +Guin & Rob + +In this session, we will cover how contributors interact with the kubernetes codebase on github. Join us as we dive into the Git Workflow used throughout the kubernetes project, including how Labels and Bots play a key role in managing issues and prs. + +### Afternoon Sessions + +### [Local Build & Test](https://github.com/kubernetes/community/blob/master/events/events-team/content/new-contributor-workshops/build-and-test.md) - 1hour ( Or Maybe More? ) 13:30 - 14:30 + +Ben + +Build Kubernetes binaries locally, and do some fun things with them. + +* Live workshop + +* This part can be really flexible + +* Walkthrough workspace set up + +* Step-by-step DevProcess + +* Fun with Go and Kind cluster ( some previous examples) + +* Resolving set up issues + +* Could we do something else here? + +* Modify a controllers behavior + +### You! Yes you can review a PR! 15-20m 14:30 - 14:50 + +Alison? With help from Tim +Look at Tim’s talk from SD + +In this session attendees will learn the in’s and outs of reviewing pull requests. We will go through a reviewing a pull request onstage, and provide some good starting points. + +### [Finding Your First Issue](https://github.com/kubernetes/community/blob/master/events/events-team/content/new-contributor-workshops/first-issue-help.md) / Closing Remarks 15m 14:50 - 15:15 + +To close the Intermediate contributor workshop, The intermediate contributor workshop team will share their tips and tricks of finding a first issue, and stories of their first contributions. + diff --git a/mentoring/programs/contributor-workshop/OWNERS b/mentoring/programs/contributor-workshop/OWNERS new file mode 100644 index 00000000..0c10d897 --- /dev/null +++ b/mentoring/programs/contributor-workshop/OWNERS @@ -0,0 +1,17 @@ +reviewers: + - alisondy + - guineveresaenger + - jberkus + - jeefy + - tpepper + +approvers: + - alisondy + - guineveresaenger + - jberkus + - jeefy + - tpepper + +labels: + - area/mentorship-planning + - sig/contributor-experience \ No newline at end of file diff --git a/mentoring/programs/contributor-workshop/README.md b/mentoring/programs/contributor-workshop/README.md new file mode 100644 index 00000000..c0ebd557 --- /dev/null +++ b/mentoring/programs/contributor-workshop/README.md @@ -0,0 +1,8 @@ +# NCW Workshops + +## Upcoming Workshops + +None scheduled + +## Previous Workshops +* [2019 NA Contributor Summit NCW](https://www.youtube.com/watch?v=uUJrGwAom-E&list=PL69nYSiGNLP0OWp38tPBc-jSlMmwWr6Ci&index=16) (Videos in playlist, links to first NCW video) diff --git a/mentoring/programs/contributor-workshop/resources/README.md b/mentoring/programs/contributor-workshop/resources/README.md new file mode 100644 index 00000000..917fb5a0 --- /dev/null +++ b/mentoring/programs/contributor-workshop/resources/README.md @@ -0,0 +1,40 @@ +# New Contributor Workshops Resources + + +## Overview + +This folder contains the [handbook for the New Contributor Workshop Content Lead](./new-contributor-workshop-lead.md) as well as playbooks for each of the New Contributor Workshop sessions. + +This workshop is held periodically by the Kubernetes Community, but materials and processes may be used at contributor focused summits and events anywhere. + +Slides from previous New Contributor Workshops can be found [here](https://github.com/cncf/presentations/blob/master/kubernetes/README.md#kubernetes-new-contributor-workshops). + +## Sample Track for Beginner Workshop + +This workshop is meant for folks who have never contributed to opensource before and/or need help setting up a Kubernetes developer environment. + +1. Welcome +1. [Live PR Demo](./live-pr-demo.md) +1. [Paths to Contributorship](./contributor-paths.md) +1. [Communication in the Kubernetes Community](./how-we-communicate.md) +1. [Community Group and Governance Overview](./community-groups.md) +1. [Kubernetes Orgs Overview](./repo-tour.md) +1. [Workspace Setup](./workspace-setup.md) +1. [Local Build&Test](./build-and-test.md) +1. [Pull Request Exercise](./playground-exercise.md) +1. [Find Your First Issue](./first-issue-help.md) + +## Sample Track for Intermediate Workshop + +This workshop differs from the Beginner workshop in that participants are expected to have a working Docker/Kubernetes/Go setup. They have a basic understanding of how opensource contributions work, and may have opened a PR against Kubernetes before. + +1. Welcome +1. [Live PR Demo](./live-pr-demo.md) +1. [Paths to Contributorship](./contributor-paths.md) +1. [Communication in the Kubernetes Community](./how-we-communicate.md) +1. [Community Group and Governance Overview](./community-groups.md) +1. [Kubernetes Orgs Overview](./repo-tour.md) +1. k/k Walkthrough +1. [Local Build&Test](./build-and-test.md) +1. [Labels, Bots and Git Workflow](./labels-and-bots.md) +1. [Find Your First Issue](./first-issue-help.md) diff --git a/mentoring/programs/contributor-workshop/resources/build-and-test.md b/mentoring/programs/contributor-workshop/resources/build-and-test.md new file mode 100644 index 00000000..147d91a3 --- /dev/null +++ b/mentoring/programs/contributor-workshop/resources/build-and-test.md @@ -0,0 +1,27 @@ +## Build and Test + +### Duration + +40-60 minutes, depending on beginner vs intermediate participants + +### Task Overview + +Build Kubernetes binaries locally, and do some fun things with them. + +**Important** Have facilitators to help with technical issues (2-3 is enough for Intermediate, you want 5 for Beginner) + +### Slides + +Clear command line instructions. + +### Details To Cover + +- This is the hands-on part. Details are up to you; look to previous workshops for inspiration. +- Adjust difficulty based on whether this is the Beginner or Intermediate workshop. +- It is _extremely important_ to run this part of the workshop several times previously, and to make sure that versions match those in the [workspace setup](./workspace-setup.md). + +### Ideas + +- Do a fun thing with the Kubernetes [go client](https://git.k8s.io/client-go) and a [kind](https://sigs.k8s.io/kind) cluster. +- Build and modify `kubectl`. +- Try a `make` command; be aware you may need to give docker a lot of space on your machine for a successful build. diff --git a/mentoring/programs/contributor-workshop/resources/community-groups.md b/mentoring/programs/contributor-workshop/resources/community-groups.md new file mode 100644 index 00000000..01a8c80c --- /dev/null +++ b/mentoring/programs/contributor-workshop/resources/community-groups.md @@ -0,0 +1,27 @@ +## Community Groups + +### Duration + +15 minutes + +### Task Overview + +Introduce SIGs, Working Groups, and a tiny bit of governance (if you must). + +### Slides + +Refer to previous workshops for inspirations. + +### Details To Cover + +- SIGs +- Subprojects +- Working Groups +- User Groups +- Committees +- How to Join Any Of The Above + +### Ideas + +- Stay simple. Don't make it too complicated. +- Ask participants to define a few example SIGs via audience interaction. \ No newline at end of file diff --git a/mentoring/programs/contributor-workshop/resources/contributor-paths.md b/mentoring/programs/contributor-workshop/resources/contributor-paths.md new file mode 100644 index 00000000..d14691eb --- /dev/null +++ b/mentoring/programs/contributor-workshop/resources/contributor-paths.md @@ -0,0 +1,26 @@ +## Contributor Paths + +### Duration + +10-30 minutes + +### Task Overview + +This is about contributor origin stories. + +### Slides + +Refer to previous workshops for inspirations + +### Details To Cover + +- Who can contribute? +- What skills are needed? +- How to Fit Contributions Into Your Job +- Balance knowledge with learning and the needs of the project + +### Ideas + +- Share some contributor origin stories +- Ask the room why they are at the workshop +- Have a few people share their thoughts diff --git a/mentoring/programs/contributor-workshop/resources/first-issue-help.md b/mentoring/programs/contributor-workshop/resources/first-issue-help.md new file mode 100644 index 00000000..b99488af --- /dev/null +++ b/mentoring/programs/contributor-workshop/resources/first-issue-help.md @@ -0,0 +1,31 @@ +## Finding Your First Issue + +### Duration + +20 minutes + +### Task Overview + +Set participants on as much of a paved path to contributor success as possible. +At this point in the workshop, participants should know what kind of issue they want to tackle. + +### Slides + +Refer to previous workshops for inspirations + +### Details To Cover + +- help-wanted and good-first-issue labels +- Up and coming sandbox projects +- Working with your SIG +- Refer participants to specific SIGs +- How to "claim" an issue (since non-members cannot self-assign) +- Path to [membership](/community-membership.md) + +### Ideas + +- Give folks time to discuss and help each other +- Gather information from SIGs in advance (via Slack, Twitter...) on who needs help, and at what level +- Prepare a list of issues and assign folks right there +- Connect participants to mentoring tracks if available (e.g. Release Team Shadow) + diff --git a/mentoring/programs/contributor-workshop/resources/how-we-communicate.md b/mentoring/programs/contributor-workshop/resources/how-we-communicate.md new file mode 100644 index 00000000..777929e2 --- /dev/null +++ b/mentoring/programs/contributor-workshop/resources/how-we-communicate.md @@ -0,0 +1,33 @@ +## How We Communicate + +### Duration + +10-30 minutes + +### Task Overview + +Show how we communicate in the community, and which tools are for what purpose. + +### Slides + +Refer to previous workshops for inspirations. + +### Details To Cover + +- [Code of Conduct](https://git.k8s.io/community/code-of-conduct.md) (CoC) +- Where We Talk: + - Slack + - Discuss +- How We Decide: + - GitHub + - Zoom + - Mailing List +- Calendar +- Meetups + +### Ideas + +- Have a #ncw channel on Slack. The first person who finds the Slack channel with the most members, or the longest name(etc) and posts in here wins a prize! +- Everyone introduces their neighbor and a cool Kubernetes fact about them in a Slack or Discuss channel/topic. +- Put an easter egg in the mailing list and whoever discovers it first by joining and reading the discussions, wins a prize! +- Come up with the most creative TL;DR for the CoC. \ No newline at end of file diff --git a/mentoring/programs/contributor-workshop/resources/labels-and-bots.md b/mentoring/programs/contributor-workshop/resources/labels-and-bots.md new file mode 100644 index 00000000..0e191f03 --- /dev/null +++ b/mentoring/programs/contributor-workshop/resources/labels-and-bots.md @@ -0,0 +1,25 @@ +## Labels and Bots + +### Duration + +10 - 15 minutes + +### Task Overview + +Show the Kubernetes automation and PR workflow, as well as the bot command help page. +This task is meant as a short overview for Intermediate content. + +### Slides + +The [PR workflow diagram](https://git.k8s.io/community/blob/master/contributors/guide/git_workflow.png) is useful here. There are also previous slides that explain the differnet labels. + +### Details To Cover + +- Which labels are used how, and by whom? +- How to add labels +- Other bot commands +- Prow + +### Ideas + +- Play with bots in the [contributor playground](https://sigs.k8s.io/contributor-playground) diff --git a/mentoring/programs/contributor-workshop/resources/live-pr-demo.md b/mentoring/programs/contributor-workshop/resources/live-pr-demo.md new file mode 100644 index 00000000..27b6c97e --- /dev/null +++ b/mentoring/programs/contributor-workshop/resources/live-pr-demo.md @@ -0,0 +1,24 @@ +## Live PR Demo + +### Duration + +Plan for about 30 minutes + +### Task Overview + +Demonstrate opening a pull request against the [Kubernetes/Kubernetes](https://git.k8s.io/kubernetes) (k/k) repository. There are some docs cleanup good-first-issues, but feel free to show off something you've been working on for a while. + +### Slides + +None; this is a live demo. + +### Details To Cover + +- Make sure to prepare code in advance but only commit locally +- Show the k/k pull request workflow +- Show the PR templates and fill them out, explaining why +- Interact with the bot and briefly mention labels/OWNERS files +- Leave room for questions, but be aware that the workflow will be covered in depth later. + +### Ideas +- ask the audience or a pre-planned reviewer for code review, showing more of the k/k automation diff --git a/mentoring/programs/contributor-workshop/resources/new-contributor-workshop-lead.md b/mentoring/programs/contributor-workshop/resources/new-contributor-workshop-lead.md new file mode 100644 index 00000000..b6398d28 --- /dev/null +++ b/mentoring/programs/contributor-workshop/resources/new-contributor-workshop-lead.md @@ -0,0 +1,54 @@ +# New Contributor Workshop Lead + +## Overview +The New Contributor Workshop Lead is in charge of planning and executing the New Contributor Workshop. They will coordinate with the overall Events Team and the organizers of related activities aimed at new contributors. + +## Skills and Qualifications + +The New Contributor Content Lead must be a current, active Kubernetes contributor who is knowledgeable of the community and organizational structure of the Kubernetes project, as well as familiar with building and developing Kubernetes. +They should have experience and be comfortable with teaching in a workshop setting and presenting interactively in front of an audience. +Additionally, they must be able to relate to and empathize with newcomers of many different experience levels. +As this role is part of a subproject of SIG-contributor-experience, the New Contributor Content Lead must be a member of SIG-contributor-experience. + +## Activities + +*These tasks reflect a rough timeline leading from the end of the previous New Contributor Workshop to the currently planned one.* +- Attend event planning meetings in preparation for the New Contributor Workshop, where applicable. +- Create a Workshop Content Proposal and link in an Issue to k/community: + - determine sessions and their overall topic (e.g. How We Communicate, Code Base Walkthrough, etc) + - determine what difficulty/experience levels will be offered, if any, and coordinate with Lead + - determine workshop capacity, and coordinate with Lead + - determine room requirements (size, number, table/chair layout, A/V) and coordinate with the planning team +- Coordinate with New Contributor Content Shadows to prepare them for leading this role. +- Recruit and coordinate with workshop teachers for any sessions/topics you do not wish to teach yourself (e.g. invite someone to speak on "Communication in the Kubernetes Project"). +- Make modifications and continuous improvements to the new contributor workshop template. +Incorporate feedback from previous New Contributor Workshops. +Shadows and co-presenters are expected to assist and review these updates. +[Past presentations are linked here](https://github.com/cncf/presentations/tree/master/kubernetes) - please make a copy of the existing deck before updating/editing. +- Work with Registration to: + - disseminate course materials (slides) in advance + - ensure participants sign the CLA + - ensure attendees meet technical and experience requirements for their course + - obtain a comprehensive list of names, emails, and GitHub handles +- Ensure to advertise the SIG-Intros. +- Solicit feedback from workshop participants. + +## Time Commitment + +1-2 hours/week most of the time, 4-5 in the weeks leading up to NCW, depending on previous teaching/shadowing experience. + +## Coupon Codes + +If you would like to share coupon codes for the CNCF store with your +attendees, please create an issue in the [kubernetes/funding] repo and +assign [SIG Contributor Experience chairs] for approval. + +The funding request should contain the following details: +- Number of coupon codes required +- Desired amount of each coupon code (e.g. $20) OR desired swags for each coupon code (e.g. 1 Tshirt, 2 stickers) + +Once the request is approved, the chairs will create a CNCF Service Desk +ticket to get the list of coupon codes. + +[kubernetes/funding]: https://github.com/kubernetes/funding +[SIG Contributor Experience chairs]: /sig-contributor-experience#chairs diff --git a/mentoring/programs/contributor-workshop/resources/playground-exercise.md b/mentoring/programs/contributor-workshop/resources/playground-exercise.md new file mode 100644 index 00000000..6aca9178 --- /dev/null +++ b/mentoring/programs/contributor-workshop/resources/playground-exercise.md @@ -0,0 +1,28 @@ +## Playground Exercise + +### Duration + +30 - 50 minutes + +### Task Overview + +Give new contributors the experience of the Kubernetes GitHub workflow! +This task requires some setup and planning. + +Create a New Contributor Workshop folder specific to this event, with teachers' and participants' GitHub handles in the OWNERS file. +[Here is an example](https://sigs.k8s.io/contributor-playground/seattle). Make sure to obtain participants' GitHub handles from the event registrar in advance. +Issue and PR exercise ideas can be found [here](https://sigs.k8s.io/contributor-playground/exercises). + +### Slides + +Refer to previous workshops for inspirations. + +### Details To Cover + +- Labels and bot commands - more material [here](./labels-and-bots.md) +- Automation +- How to assign reviewers + +### Ideas + +- The first person to `/honk` on a PR wins a prize! diff --git a/mentoring/programs/contributor-workshop/resources/repo-tour.md b/mentoring/programs/contributor-workshop/resources/repo-tour.md new file mode 100644 index 00000000..d1f46ee0 --- /dev/null +++ b/mentoring/programs/contributor-workshop/resources/repo-tour.md @@ -0,0 +1,24 @@ +## Repo Tour + +### Duration + +10 - 15 minutes + +### Task Overview + +Show that Kubernetes is not just about the Core Repository, but also about the other repos in the org and in kubernetes-sigs. + +### Slides + +Have a few overview slides, but also go off-book and live show the repos on GitHub. + +### Details To Cover + +- k/website, k/test-infra, k/community, k/enhancements, with explanations +- Exciting things in kubernetes-sigs + + +### Ideas + +- Ask participants if they have found or are interested in specific repos, and share about their purpose. +- Mention which repos need help, or have awesome good-first-issue shepherding from maintainers! \ No newline at end of file diff --git a/mentoring/programs/contributor-workshop/resources/workspace-setup.md b/mentoring/programs/contributor-workshop/resources/workspace-setup.md new file mode 100644 index 00000000..19dbef29 --- /dev/null +++ b/mentoring/programs/contributor-workshop/resources/workspace-setup.md @@ -0,0 +1,24 @@ +## Workspace Setup + +### Duration + +Plan for 90- 120 minutes of download and setup time when on wifi. When on a workshop specific network, this may be much shortened. + +### Task Overview + +Make sure all Beginning Contributors have a workspace setup for hacking on Kubernetes. + +**Important** Have facilitators to help with technical issues (3-5 for ~30 people) + +### Slides + +Clear and large download commands to copy into the terminal. + +### Details To Cover + +- Make sure everyone has the correct setup for a local build and test demo. + +### Ideas + +- Have a dedicated workshop network. +- When internet is slow, start the download and prep process during earlier sessions, to make sure everyone is up to date. diff --git a/mentoring/programs/contributor-workshop/videoguide.md b/mentoring/programs/contributor-workshop/videoguide.md new file mode 100644 index 00000000..2e96183f --- /dev/null +++ b/mentoring/programs/contributor-workshop/videoguide.md @@ -0,0 +1,131 @@ +# Video Recording Guide for NCW2 DRAFT + + +## Introduction + + +## Setting up Your Video Environment + + +### Video + +The primary video in your NCW presentation will be screen-sharing, but it's also great if you can have some webcam segments. New contributors want to see the faces of current contributors. + + +#### Webcam Recording + +Use an external webcam. 1080p preferred or 720p at a minimum. Typically, either will be better quality than the built-in camera on your laptop. They often have an autofocus function and auto + +lighting adjustments that help you get a better camera feed in less than optimal lighting conditions. + +It’s best to optimize the ambient lighting within your space first. There should be no window or strong light source behind you that darkens your face and no strong light source from one side that casts a shadow on the opposite side of your face. Good ambient lighting from your ceiling lights or windows may be enough as long as they are in front of you. Diffused lighting is better than harsh, direct lighting. + + + + + +Webcam tips: + + + +* Background – keep it clean and uncluttered. It’s great to show off your personality/style in your home, just be sure to keep everything appropriate for a general audience and compliant with the Code of Conduct. A plain wall is also just fine, no need to overdo it. +* Position the camera as close as possible at your eye level, not pointing up towards your nose or the ceiling, or down towards the floor. It can be as simple as raising your laptop via a few books. Or if you have an external webcam, position it on the top edge or close to the top of the screen from which you are advancing your slides/notes. +* Keep eye contact with the camera just like you would look at your audience during an in-person presentation. +* Check [https://drive.google.com/drive/u/1/folders/1cvGcRgX9IWNR_csNVJ0nWRYD65Wmx9hu](https://drive.google.com/drive/u/1/folders/1cvGcRgX9IWNR_csNVJ0nWRYD65Wmx9hu) for virtual background images if you’d like to use them. + +Please, check the 4 minute video: [https://youtu.be/rGcAM1CNEU0](https://youtu.be/rGcAM1CNEU0) for more tips and examples. + + +#### Resolution + +Videos should ideally be recorded at 1080p or 720p if you’re using a video device, or at one of the following resolutions for screencasts: + + + +* 1440x1080 +* 1440x900 +* 1280x960 +* 1368x768 +* 1280x800 +* 1280x720 +* 1024x768 + +Particularly, do not record the video on the highest resolution your computer offers, such as 3200x1800. Such large screen sizes will make it difficult for folks with low bandwidth or older computers to view your broadcast. If you have a high-resolution screen on your computer, this may mean downgrading the resolution for screencasting. + + +### Audio + +Good audio is important. All recorded NCW segments have audio and this is the most important element that reinforces your presentation slides. In addition to software, you'll need hardware for recording audio. We realize that you don't necessarily have a chance to purchase or borrow the best audio equipment for an NCW video, but here's a few recommendations: + +**Best:** External microphone (condenser recommended over dynamic*) usually via a USB connection (e.g. Blue / Rhode / Razer brands). This type of microphone allows you to keep your mouth somewhat distant from the microphone, not up very close. You should try to keep it out of the video shot. + +**Good:** A headset with microphone, even if it’s earbud type with the mic on the lanyard. It’s about isolating microphone pick-up from ambient noises within your recording/streaming space. Input via USB or single mini-jack is typical or it can be dual minijack for older laptops/PCs. Cordless headsets also work, but it's better to use radio frequency dongles (RF) than bluetooth, which tends to produce sound quality issues. + +**Acceptable:** External microphone built into your webcam. Often better quality than your built-in laptop microphone. + +**Worst:** Your built-in laptop microphone. These are generally low-quality microphones, and they have little or no ability to filter out background noise. + +In general, it’s best to be in a controlled environment with little to no background noise and mute all other audio devices that are not necessary. + + + + +### Console Sessions + +Please, don’t forget to increase the font size when sharing a console. + + +## Recording Options and Instructions + + +### Zoom + + + +* Start a meeting in zoom (you can start and record a meeting with a single participant) +* Get the presentation slide setup with the screenshare. +* Once thats all setup click the record button +* when you click end meeting the video should export locally if you're doing the local record option +* Rename and copy mp4 file to google drive folder: [https://drive.google.com/drive/u/1/folders/1cvGcRgX9IWNR_csNVJ0nWRYD65Wmx9hu](https://drive.google.com/drive/u/1/folders/1cvGcRgX9IWNR_csNVJ0nWRYD65Wmx9hu) + + + +### Documentation and Exercises + + +### Where to Upload + +[https://drive.google.com/drive/u/1/folders/1cvGcRgX9IWNR_csNVJ0nWRYD65Wmx9hu](https://drive.google.com/drive/u/1/folders/1cvGcRgX9IWNR_csNVJ0nWRYD65Wmx9hu) - please upload all video files here. + + +## Tips + + +## Equipment Recommendations + +Here are some equipment recommendations from the CNCF: + +Headset Microphones: + +Logitech / Plantronics – i.e. Logitech H111 / Logitech H390 / Plantronics C225 + +External Microphones: + +Blue / Samson – i.e. Blue Snowball / Blue Yeti / Samson Meteor / Samson G-Track + +Webcams: + +Good value – Logitech C270 + +Value + added features – Logitech B525/C615 + +Higher resolution, better microphone – Logitech 9series / Microsoft LifeCam + +More info – https://www.tomsguide.com/news/where-to-buy-webcams-now-these-retailers-have-stock + +Presentation remotes: + +Logitech / Canon / Kensington / SMK + +Tested and recommended for PC or Mac – Logitech R400, R800, Spotlight / Canon PR500, PR100 + diff --git a/mentoring/programs/new-contributor-workshop/2020/03-contributor-summit/README.md b/mentoring/programs/new-contributor-workshop/2020/03-contributor-summit/README.md deleted file mode 100644 index 283fe402..00000000 --- a/mentoring/programs/new-contributor-workshop/2020/03-contributor-summit/README.md +++ /dev/null @@ -1,13 +0,0 @@ -## NCW Workshop Amsterdam - -## Team - -| Name & Handle | Role | Timezone | -|---------------|------|----------| -| | | | -| | | | -| | | | - -## Deadlines - -## Meeting Information diff --git a/mentoring/programs/new-contributor-workshop/2020/03-contributor-summit/content-proposal.md b/mentoring/programs/new-contributor-workshop/2020/03-contributor-summit/content-proposal.md deleted file mode 100644 index 93ea95d3..00000000 --- a/mentoring/programs/new-contributor-workshop/2020/03-contributor-summit/content-proposal.md +++ /dev/null @@ -1,165 +0,0 @@ -# Content Proposal for NCW Amsterdam - -## Introduction - -### 9:30 - 11:00 Intro Communications and Community -Alison, Rob, Rael, Josh: support/segment? - -Provide an overview on how the community works as a project both in terms of coordinating people and the special interest groups that those people participate in and the workflow that are used to accept new features, bug fixes. - -Note: Although these will have to be run separately, the content will be the same. - -## NCW Topics 101 - -This workshop will help a complete newcomer to Kubernetes get a running start as a contributor. Learn how to set up your developer environment, how to find your first contribution, and how to navigate the Kubernetes GitHub workflow. We will focus on a community approach to solving challenges, and on being good open source citizens. - -### Morning Session - -#### 11:00 - 12:00 [Workspace Setup](https://github.com/kubernetes/community/blob/master/events/events-team/content/new-contributor-workshops/workspace-setup.md) Tim & Rael - -Make sure all Beginning Contributors have a workspace setup for hacking on Kubernetes - -#### 12:00 - 12:30 [Local Build Test](https://github.com/kubernetes/community/blob/master/events/events-team/content/new-contributor-workshops/build-and-test.md) Tim & Rael -#### 13:30 - 14:00 [Local Build Test](https://github.com/kubernetes/community/blob/master/events/events-team/content/new-contributor-workshops/build-and-test.md) Tim & Rael - -Build Kubernetes binaries locally, and do some fun things with them. - -### Afternoon Sessions - -#### 14:00 - 14:45 [Pull Request Exercise](https://github.com/kubernetes/community/blob/master/events/events-team/content/new-contributor-workshops/playground-exercise.md) Guinevere, Rob - -Give new contributors the experience of the Kubernetes GitHub workflow! - -This task requires some setup and planning. Labels, Bots - -#### 14:45 - 15:15 [Find Your First Issue](https://github.com/kubernetes/community/blob/master/events/events-team/content/new-contributor-workshops/first-issue-help.md) Jeff - -Set participants on as much of a paved path to contributor success as possible. At this point in the workshop, participants should know what kind of issue they want to tackle. - -## NCW Topics 201 - -This workshop focuses on the **more experienced** open source contributor. You may have sent patches to Kubernetes before, but may have gotten stuck or overwhelmed somewhere along the line. Take your contributor journey to the next level by learning about the main Kubernetes code base, how to build and test Kubernetes, and how to find reviewers and collaborators for your issue patches. - -### Morning Session - -#### 11:00 - 12:00 K/K Walkthrough Alison - -Alison - -Guided tour of the main k/k repository, to build a broader understanding of how the codebase is structured - -#### 12:00 - 12:25 Labels, Bots and Git Workflow Guin & Rob - -In this session, we will cover how contributors interact with the kubernetes codebase on github. Join us as we dive into the Git Workflow used throughout the kubernetes project, including how Labels and Bots play a key role in managing issues and prs. - -### Afternoon Sessions - -#### 13:30 - 14:30 [Local Build & Test](https://github.com/kubernetes/community/blob/master/events/events-team/content/new-contributor-workshops/build-and-test.md) - 1hour ( Or Maybe More? ) Ben - -Build Kubernetes binaries locally, and do some fun things with them. - -#### 14:30 - 14:50 You! Yes you can review a PR! 15-20m Alison & Tim H - -In this session attendees will learn the in’s and outs of reviewing pull requests. We will go through a reviewing a pull request onstage, and provide some good starting points. - -#### 14:50 - 15:15 [Finding Your First Issue](https://github.com/kubernetes/community/blob/master/events/events-team/content/new-contributor-workshops/first-issue-help.md) / Closing Remarks 15m - -To close the Intermediate contributor workshop, The intermediate contributor workshop team will share their tips and tricks of finding a first issue, and stories of their first contributions. - -## Resources To Create - -* Capture who is presenting what - -* Slides to reflect the content proposal - -* Assign presenters for each section so presenters own their own slides - -* Docker Image Registry - - * Source Tree in a Docker Image incase of networking issues - - * [Sheet of what will be on the Harbor box](https://docs.google.com/spreadsheets/d/1_CUFluzIgeHt4vra9hs6OqBqDZQ8oUl9Og-IixkoEAM/edit?usp=sharing) - - * Add the needed container images, other binaries you want, and specific versions - -* Know before you go details - - * Instructions, What to install on your laptop, Sign the CLA - -* Can we link and update the handbooks here? Every presenter can update the handbooks as content matures! - -* On the day plan - More indepth dive of what happens - -### On The Day / Extra Notes -[runbook.md](runbook.md) - -### Handbooks -[../resources](../resources) - -### Slides -[https://docs.google.com/presentation/d/19OtCzuDTVeeIfMD39OOODGJzkV3UGM_nr7jpSNhoy2s/edit?ts=5e4b8bc8#slide=id.g52cc57d172_7_69](https://docs.google.com/presentation/d/19OtCzuDTVeeIfMD39OOODGJzkV3UGM_nr7jpSNhoy2s/edit?ts=5e4b8bc8#slide=id.g52cc57d172_7_69) - -## Slide Ideas - -* Solidify formatting for each type of slide - - * Code with instructions - - * Main Image - - * Image with text - - * Title Slides - - * Schedule Slides - -* Retro notes - Be a bit more creative with the slides, Do we want to do a direct copy paste of the slides from last time - -* From San Diego page -*Try to represent the journey of a contributor with the slides* - -* *Linking the key ideas themes, with walking along a brick road or similar. From cat to kubecat. *Or capybara to kubeybara - -* Break Slides - -* *Is a long presentation, adding a timeline at the bottom can help the attendees follow the presentation. This can go with the idea of showing the progress of the contributor as we move forward with the presentation. - I love this! -guin* - -## References - -San Diego Contributor Summit Content Proposal - -[https://docs.google.com/document/d/1ha3KtgLcRIY7IaRi9pm_h28xVsx9VoVLu8Fl1YO-eCI/edit?pli=1#heading=h.c2mvd8re7lpn](https://docs.google.com/document/d/1ha3KtgLcRIY7IaRi9pm_h28xVsx9VoVLu8Fl1YO-eCI/edit?pli=1#heading=h.c2mvd8re7lpn) - -Last years sched for san diego - -[https://kcsna2019.sched.com/](https://kcsna2019.sched.com/) - -Reference - -[https://github.com/kubernetes/community/blob/master/events/events-team/content/new-contributor-workshops/README.md](https://github.com/kubernetes/community/blob/master/events/events-team/content/new-contributor-workshops/README.md) - -## Virtual Event Go/No Go - -Alison: Go (speaking live) - -Jeff: Go (streaming/speaking live) - -Josh: Go (pre-record; virtual Q&A) - -Guin: Go (pre-record) - -James M: - -Rob: Go (Flexible; assign content ASAP) - -Chris Short: Go (shadow; streaming) - -Samudrala: Can present - -Nabarun: Can present - -Tim P: Can present (shadow) - -Rael: No Go - -Ben: No Go diff --git a/mentoring/programs/new-contributor-workshop/2020/03-contributor-summit/runbook.md b/mentoring/programs/new-contributor-workshop/2020/03-contributor-summit/runbook.md deleted file mode 100644 index 57369a71..00000000 --- a/mentoring/programs/new-contributor-workshop/2020/03-contributor-summit/runbook.md +++ /dev/null @@ -1,160 +0,0 @@ -# NCW On The Day Runbook / Extra Notes - -### 9:30 - 11:00 Intro Communications and Community -Alison, Rob, Rael, Josh: support/segment? - -Sections - -* Welcome & PR Demo [Slide 6](https://docs.google.com/presentation/d/19OtCzuDTVeeIfMD39OOODGJzkV3UGM_nr7jpSNhoy2s/edit#slide=id.g64b51f6423_1_0) - -* Why Contribute / Origin Story [Slide 10](https://docs.google.com/presentation/d/19OtCzuDTVeeIfMD39OOODGJzkV3UGM_nr7jpSNhoy2s/edit#slide=id.g5e6254b17b_4_1168) - - * Why - - * Origin Story - - * Choose your adventure - - * Find your topic - -* Communications [Slide 13](https://docs.google.com/presentation/d/19OtCzuDTVeeIfMD39OOODGJzkV3UGM_nr7jpSNhoy2s/edit#slide=id.g5e6254b17b_4_1185) - - * How we communicate - - * Standards - - * Asking tech Q’s - -* Community Groups/Organization/SIG Tour: Josh? [Slide 29](https://docs.google.com/presentation/d/19OtCzuDTVeeIfMD39OOODGJzkV3UGM_nr7jpSNhoy2s/edit#slide=id.g5e6254b17b_4_1266) - -* Repo Tour: Samudrala [Slide 52](https://docs.google.com/presentation/d/19OtCzuDTVeeIfMD39OOODGJzkV3UGM_nr7jpSNhoy2s/edit#slide=id.g645f82e308_0_17) - -* How to find what you need: Alison [Slide 55](https://docs.google.com/presentation/d/19OtCzuDTVeeIfMD39OOODGJzkV3UGM_nr7jpSNhoy2s/edit#slide=id.g7eae03886b_2_18) - - * https://cs.k8s.io/ - -Josh: I can take any of the above that someone else doesn't want. - -#### Notes and cool ideas - -#### Communications Tools - -Discuss, Slack, Mailing List, Github, Twitter - -#### Kubernetes Podcasts - -#### Periodic Meetings - -Office Hours, Community Meeting - -#### Scavenger Hunt - -Register in k8s slack, post a Hi to the New Contributor Workshop Room - -Post a commit made by Joe Beda that contains a TODO to a special NCW Amsterdam discuss Thread. Oldest TODO wins. - -Find and favorite a NCW Easter Egg post in the NCW Amsterdam room - -Find and heart a k8s First Good Issue on Github - -#### -Main content - -Live PR Demo - -Paths to Contributorship - -Communication in the Kubernetes Community - -Community Group and Governance - -Orgs Overview - -How to find what you need in the community - -Tips and tricks to interact with the community -Teach people to answer their own questions - -[cs.k8s.io](https://cs.k8s.io/) - -How to phrase questions - -Limitations of GitHub searches - -Traversing K8s docs - -List speakers and roles for each section - -## NCW Topics 101 - -### 11:00 - 12:00 [Workspace Setup](https://github.com/kubernetes/community/blob/master/events/events-team/content/new-contributor-workshops/workspace-setup.md) Tim & Rael - -**Make sure all Beginning Contributors have a workspace setup for hacking on Kubernetes** - -### 12:00 - 12:30 [Local Build Test](https://github.com/kubernetes/community/blob/master/events/events-team/content/new-contributor-workshops/build-and-test.md) Tim & Rael - -### 13:30 - 14:00 [Local Build Test](https://github.com/kubernetes/community/blob/master/events/events-team/content/new-contributor-workshops/build-and-test.md) **Tim & Rael** - -**Build Kubernetes binaries locally, and do some fun things with them.** - -### 14:00 - 14:45 [Pull Request Exercise](https://github.com/kubernetes/community/blob/master/events/events-team/content/new-contributor-workshops/playground-exercise.md) **Guinevere, Rob** - -**Give new contributors the experience of the Kubernetes GitHub workflow! ** - -**This task requires some setup and planning. Labels, Bots** - -### 14:45 - 15:15 [Find Your First Issue](https://github.com/kubernetes/community/blob/master/events/events-team/content/new-contributor-workshops/first-issue-help.md) **Jeff** - -Set participants on as much of a paved path to contributor success as possible. At this point in the workshop, participants should know what kind of issue they want to tackle. - -## NCW Topics 201 - -### Morning Session - -### K/K Walkthrough 11:00 - 12:00 - -Alison - -Guided tour of the main k/k repository, to build a broader understanding of how the codebase is structured - -### Labels, Bots and Git Workflow 12:00 - 12:25 - -Guin & Rob - -In this session, we will cover how contributors interact with the kubernetes codebase on github. Join us as we dive into the Git Workflow used throughout the kubernetes project, including how Labels and Bots play a key role in managing issues and prs. - -### Afternoon Sessions - -### [Local Build & Test](https://github.com/kubernetes/community/blob/master/events/events-team/content/new-contributor-workshops/build-and-test.md) - 1hour ( Or Maybe More? ) 13:30 - 14:30 - -Ben - -Build Kubernetes binaries locally, and do some fun things with them. - -* Live workshop - -* This part can be really flexible - -* Walkthrough workspace set up - -* Step-by-step DevProcess - -* Fun with Go and Kind cluster ( some previous examples) - -* Resolving set up issues - -* Could we do something else here? - -* Modify a controllers behavior - -### You! Yes you can review a PR! 15-20m 14:30 - 14:50 - -Alison? With help from Tim -Look at Tim’s talk from SD - -In this session attendees will learn the in’s and outs of reviewing pull requests. We will go through a reviewing a pull request onstage, and provide some good starting points. - -### [Finding Your First Issue](https://github.com/kubernetes/community/blob/master/events/events-team/content/new-contributor-workshops/first-issue-help.md) / Closing Remarks 15m 14:50 - 15:15 - -To close the Intermediate contributor workshop, The intermediate contributor workshop team will share their tips and tricks of finding a first issue, and stories of their first contributions. - diff --git a/mentoring/programs/new-contributor-workshop/OWNERS b/mentoring/programs/new-contributor-workshop/OWNERS deleted file mode 100644 index 0c10d897..00000000 --- a/mentoring/programs/new-contributor-workshop/OWNERS +++ /dev/null @@ -1,17 +0,0 @@ -reviewers: - - alisondy - - guineveresaenger - - jberkus - - jeefy - - tpepper - -approvers: - - alisondy - - guineveresaenger - - jberkus - - jeefy - - tpepper - -labels: - - area/mentorship-planning - - sig/contributor-experience \ No newline at end of file diff --git a/mentoring/programs/new-contributor-workshop/README.md b/mentoring/programs/new-contributor-workshop/README.md deleted file mode 100644 index c0ebd557..00000000 --- a/mentoring/programs/new-contributor-workshop/README.md +++ /dev/null @@ -1,8 +0,0 @@ -# NCW Workshops - -## Upcoming Workshops - -None scheduled - -## Previous Workshops -* [2019 NA Contributor Summit NCW](https://www.youtube.com/watch?v=uUJrGwAom-E&list=PL69nYSiGNLP0OWp38tPBc-jSlMmwWr6Ci&index=16) (Videos in playlist, links to first NCW video) diff --git a/mentoring/programs/new-contributor-workshop/resources/README.md b/mentoring/programs/new-contributor-workshop/resources/README.md deleted file mode 100644 index 917fb5a0..00000000 --- a/mentoring/programs/new-contributor-workshop/resources/README.md +++ /dev/null @@ -1,40 +0,0 @@ -# New Contributor Workshops Resources - - -## Overview - -This folder contains the [handbook for the New Contributor Workshop Content Lead](./new-contributor-workshop-lead.md) as well as playbooks for each of the New Contributor Workshop sessions. - -This workshop is held periodically by the Kubernetes Community, but materials and processes may be used at contributor focused summits and events anywhere. - -Slides from previous New Contributor Workshops can be found [here](https://github.com/cncf/presentations/blob/master/kubernetes/README.md#kubernetes-new-contributor-workshops). - -## Sample Track for Beginner Workshop - -This workshop is meant for folks who have never contributed to opensource before and/or need help setting up a Kubernetes developer environment. - -1. Welcome -1. [Live PR Demo](./live-pr-demo.md) -1. [Paths to Contributorship](./contributor-paths.md) -1. [Communication in the Kubernetes Community](./how-we-communicate.md) -1. [Community Group and Governance Overview](./community-groups.md) -1. [Kubernetes Orgs Overview](./repo-tour.md) -1. [Workspace Setup](./workspace-setup.md) -1. [Local Build&Test](./build-and-test.md) -1. [Pull Request Exercise](./playground-exercise.md) -1. [Find Your First Issue](./first-issue-help.md) - -## Sample Track for Intermediate Workshop - -This workshop differs from the Beginner workshop in that participants are expected to have a working Docker/Kubernetes/Go setup. They have a basic understanding of how opensource contributions work, and may have opened a PR against Kubernetes before. - -1. Welcome -1. [Live PR Demo](./live-pr-demo.md) -1. [Paths to Contributorship](./contributor-paths.md) -1. [Communication in the Kubernetes Community](./how-we-communicate.md) -1. [Community Group and Governance Overview](./community-groups.md) -1. [Kubernetes Orgs Overview](./repo-tour.md) -1. k/k Walkthrough -1. [Local Build&Test](./build-and-test.md) -1. [Labels, Bots and Git Workflow](./labels-and-bots.md) -1. [Find Your First Issue](./first-issue-help.md) diff --git a/mentoring/programs/new-contributor-workshop/resources/build-and-test.md b/mentoring/programs/new-contributor-workshop/resources/build-and-test.md deleted file mode 100644 index 147d91a3..00000000 --- a/mentoring/programs/new-contributor-workshop/resources/build-and-test.md +++ /dev/null @@ -1,27 +0,0 @@ -## Build and Test - -### Duration - -40-60 minutes, depending on beginner vs intermediate participants - -### Task Overview - -Build Kubernetes binaries locally, and do some fun things with them. - -**Important** Have facilitators to help with technical issues (2-3 is enough for Intermediate, you want 5 for Beginner) - -### Slides - -Clear command line instructions. - -### Details To Cover - -- This is the hands-on part. Details are up to you; look to previous workshops for inspiration. -- Adjust difficulty based on whether this is the Beginner or Intermediate workshop. -- It is _extremely important_ to run this part of the workshop several times previously, and to make sure that versions match those in the [workspace setup](./workspace-setup.md). - -### Ideas - -- Do a fun thing with the Kubernetes [go client](https://git.k8s.io/client-go) and a [kind](https://sigs.k8s.io/kind) cluster. -- Build and modify `kubectl`. -- Try a `make` command; be aware you may need to give docker a lot of space on your machine for a successful build. diff --git a/mentoring/programs/new-contributor-workshop/resources/community-groups.md b/mentoring/programs/new-contributor-workshop/resources/community-groups.md deleted file mode 100644 index 01a8c80c..00000000 --- a/mentoring/programs/new-contributor-workshop/resources/community-groups.md +++ /dev/null @@ -1,27 +0,0 @@ -## Community Groups - -### Duration - -15 minutes - -### Task Overview - -Introduce SIGs, Working Groups, and a tiny bit of governance (if you must). - -### Slides - -Refer to previous workshops for inspirations. - -### Details To Cover - -- SIGs -- Subprojects -- Working Groups -- User Groups -- Committees -- How to Join Any Of The Above - -### Ideas - -- Stay simple. Don't make it too complicated. -- Ask participants to define a few example SIGs via audience interaction. \ No newline at end of file diff --git a/mentoring/programs/new-contributor-workshop/resources/contributor-paths.md b/mentoring/programs/new-contributor-workshop/resources/contributor-paths.md deleted file mode 100644 index d14691eb..00000000 --- a/mentoring/programs/new-contributor-workshop/resources/contributor-paths.md +++ /dev/null @@ -1,26 +0,0 @@ -## Contributor Paths - -### Duration - -10-30 minutes - -### Task Overview - -This is about contributor origin stories. - -### Slides - -Refer to previous workshops for inspirations - -### Details To Cover - -- Who can contribute? -- What skills are needed? -- How to Fit Contributions Into Your Job -- Balance knowledge with learning and the needs of the project - -### Ideas - -- Share some contributor origin stories -- Ask the room why they are at the workshop -- Have a few people share their thoughts diff --git a/mentoring/programs/new-contributor-workshop/resources/first-issue-help.md b/mentoring/programs/new-contributor-workshop/resources/first-issue-help.md deleted file mode 100644 index b99488af..00000000 --- a/mentoring/programs/new-contributor-workshop/resources/first-issue-help.md +++ /dev/null @@ -1,31 +0,0 @@ -## Finding Your First Issue - -### Duration - -20 minutes - -### Task Overview - -Set participants on as much of a paved path to contributor success as possible. -At this point in the workshop, participants should know what kind of issue they want to tackle. - -### Slides - -Refer to previous workshops for inspirations - -### Details To Cover - -- help-wanted and good-first-issue labels -- Up and coming sandbox projects -- Working with your SIG -- Refer participants to specific SIGs -- How to "claim" an issue (since non-members cannot self-assign) -- Path to [membership](/community-membership.md) - -### Ideas - -- Give folks time to discuss and help each other -- Gather information from SIGs in advance (via Slack, Twitter...) on who needs help, and at what level -- Prepare a list of issues and assign folks right there -- Connect participants to mentoring tracks if available (e.g. Release Team Shadow) - diff --git a/mentoring/programs/new-contributor-workshop/resources/how-we-communicate.md b/mentoring/programs/new-contributor-workshop/resources/how-we-communicate.md deleted file mode 100644 index 777929e2..00000000 --- a/mentoring/programs/new-contributor-workshop/resources/how-we-communicate.md +++ /dev/null @@ -1,33 +0,0 @@ -## How We Communicate - -### Duration - -10-30 minutes - -### Task Overview - -Show how we communicate in the community, and which tools are for what purpose. - -### Slides - -Refer to previous workshops for inspirations. - -### Details To Cover - -- [Code of Conduct](https://git.k8s.io/community/code-of-conduct.md) (CoC) -- Where We Talk: - - Slack - - Discuss -- How We Decide: - - GitHub - - Zoom - - Mailing List -- Calendar -- Meetups - -### Ideas - -- Have a #ncw channel on Slack. The first person who finds the Slack channel with the most members, or the longest name(etc) and posts in here wins a prize! -- Everyone introduces their neighbor and a cool Kubernetes fact about them in a Slack or Discuss channel/topic. -- Put an easter egg in the mailing list and whoever discovers it first by joining and reading the discussions, wins a prize! -- Come up with the most creative TL;DR for the CoC. \ No newline at end of file diff --git a/mentoring/programs/new-contributor-workshop/resources/labels-and-bots.md b/mentoring/programs/new-contributor-workshop/resources/labels-and-bots.md deleted file mode 100644 index 0e191f03..00000000 --- a/mentoring/programs/new-contributor-workshop/resources/labels-and-bots.md +++ /dev/null @@ -1,25 +0,0 @@ -## Labels and Bots - -### Duration - -10 - 15 minutes - -### Task Overview - -Show the Kubernetes automation and PR workflow, as well as the bot command help page. -This task is meant as a short overview for Intermediate content. - -### Slides - -The [PR workflow diagram](https://git.k8s.io/community/blob/master/contributors/guide/git_workflow.png) is useful here. There are also previous slides that explain the differnet labels. - -### Details To Cover - -- Which labels are used how, and by whom? -- How to add labels -- Other bot commands -- Prow - -### Ideas - -- Play with bots in the [contributor playground](https://sigs.k8s.io/contributor-playground) diff --git a/mentoring/programs/new-contributor-workshop/resources/live-pr-demo.md b/mentoring/programs/new-contributor-workshop/resources/live-pr-demo.md deleted file mode 100644 index 27b6c97e..00000000 --- a/mentoring/programs/new-contributor-workshop/resources/live-pr-demo.md +++ /dev/null @@ -1,24 +0,0 @@ -## Live PR Demo - -### Duration - -Plan for about 30 minutes - -### Task Overview - -Demonstrate opening a pull request against the [Kubernetes/Kubernetes](https://git.k8s.io/kubernetes) (k/k) repository. There are some docs cleanup good-first-issues, but feel free to show off something you've been working on for a while. - -### Slides - -None; this is a live demo. - -### Details To Cover - -- Make sure to prepare code in advance but only commit locally -- Show the k/k pull request workflow -- Show the PR templates and fill them out, explaining why -- Interact with the bot and briefly mention labels/OWNERS files -- Leave room for questions, but be aware that the workflow will be covered in depth later. - -### Ideas -- ask the audience or a pre-planned reviewer for code review, showing more of the k/k automation diff --git a/mentoring/programs/new-contributor-workshop/resources/new-contributor-workshop-lead.md b/mentoring/programs/new-contributor-workshop/resources/new-contributor-workshop-lead.md deleted file mode 100644 index b6398d28..00000000 --- a/mentoring/programs/new-contributor-workshop/resources/new-contributor-workshop-lead.md +++ /dev/null @@ -1,54 +0,0 @@ -# New Contributor Workshop Lead - -## Overview -The New Contributor Workshop Lead is in charge of planning and executing the New Contributor Workshop. They will coordinate with the overall Events Team and the organizers of related activities aimed at new contributors. - -## Skills and Qualifications - -The New Contributor Content Lead must be a current, active Kubernetes contributor who is knowledgeable of the community and organizational structure of the Kubernetes project, as well as familiar with building and developing Kubernetes. -They should have experience and be comfortable with teaching in a workshop setting and presenting interactively in front of an audience. -Additionally, they must be able to relate to and empathize with newcomers of many different experience levels. -As this role is part of a subproject of SIG-contributor-experience, the New Contributor Content Lead must be a member of SIG-contributor-experience. - -## Activities - -*These tasks reflect a rough timeline leading from the end of the previous New Contributor Workshop to the currently planned one.* -- Attend event planning meetings in preparation for the New Contributor Workshop, where applicable. -- Create a Workshop Content Proposal and link in an Issue to k/community: - - determine sessions and their overall topic (e.g. How We Communicate, Code Base Walkthrough, etc) - - determine what difficulty/experience levels will be offered, if any, and coordinate with Lead - - determine workshop capacity, and coordinate with Lead - - determine room requirements (size, number, table/chair layout, A/V) and coordinate with the planning team -- Coordinate with New Contributor Content Shadows to prepare them for leading this role. -- Recruit and coordinate with workshop teachers for any sessions/topics you do not wish to teach yourself (e.g. invite someone to speak on "Communication in the Kubernetes Project"). -- Make modifications and continuous improvements to the new contributor workshop template. -Incorporate feedback from previous New Contributor Workshops. -Shadows and co-presenters are expected to assist and review these updates. -[Past presentations are linked here](https://github.com/cncf/presentations/tree/master/kubernetes) - please make a copy of the existing deck before updating/editing. -- Work with Registration to: - - disseminate course materials (slides) in advance - - ensure participants sign the CLA - - ensure attendees meet technical and experience requirements for their course - - obtain a comprehensive list of names, emails, and GitHub handles -- Ensure to advertise the SIG-Intros. -- Solicit feedback from workshop participants. - -## Time Commitment - -1-2 hours/week most of the time, 4-5 in the weeks leading up to NCW, depending on previous teaching/shadowing experience. - -## Coupon Codes - -If you would like to share coupon codes for the CNCF store with your -attendees, please create an issue in the [kubernetes/funding] repo and -assign [SIG Contributor Experience chairs] for approval. - -The funding request should contain the following details: -- Number of coupon codes required -- Desired amount of each coupon code (e.g. $20) OR desired swags for each coupon code (e.g. 1 Tshirt, 2 stickers) - -Once the request is approved, the chairs will create a CNCF Service Desk -ticket to get the list of coupon codes. - -[kubernetes/funding]: https://github.com/kubernetes/funding -[SIG Contributor Experience chairs]: /sig-contributor-experience#chairs diff --git a/mentoring/programs/new-contributor-workshop/resources/playground-exercise.md b/mentoring/programs/new-contributor-workshop/resources/playground-exercise.md deleted file mode 100644 index 6aca9178..00000000 --- a/mentoring/programs/new-contributor-workshop/resources/playground-exercise.md +++ /dev/null @@ -1,28 +0,0 @@ -## Playground Exercise - -### Duration - -30 - 50 minutes - -### Task Overview - -Give new contributors the experience of the Kubernetes GitHub workflow! -This task requires some setup and planning. - -Create a New Contributor Workshop folder specific to this event, with teachers' and participants' GitHub handles in the OWNERS file. -[Here is an example](https://sigs.k8s.io/contributor-playground/seattle). Make sure to obtain participants' GitHub handles from the event registrar in advance. -Issue and PR exercise ideas can be found [here](https://sigs.k8s.io/contributor-playground/exercises). - -### Slides - -Refer to previous workshops for inspirations. - -### Details To Cover - -- Labels and bot commands - more material [here](./labels-and-bots.md) -- Automation -- How to assign reviewers - -### Ideas - -- The first person to `/honk` on a PR wins a prize! diff --git a/mentoring/programs/new-contributor-workshop/resources/repo-tour.md b/mentoring/programs/new-contributor-workshop/resources/repo-tour.md deleted file mode 100644 index d1f46ee0..00000000 --- a/mentoring/programs/new-contributor-workshop/resources/repo-tour.md +++ /dev/null @@ -1,24 +0,0 @@ -## Repo Tour - -### Duration - -10 - 15 minutes - -### Task Overview - -Show that Kubernetes is not just about the Core Repository, but also about the other repos in the org and in kubernetes-sigs. - -### Slides - -Have a few overview slides, but also go off-book and live show the repos on GitHub. - -### Details To Cover - -- k/website, k/test-infra, k/community, k/enhancements, with explanations -- Exciting things in kubernetes-sigs - - -### Ideas - -- Ask participants if they have found or are interested in specific repos, and share about their purpose. -- Mention which repos need help, or have awesome good-first-issue shepherding from maintainers! \ No newline at end of file diff --git a/mentoring/programs/new-contributor-workshop/resources/workspace-setup.md b/mentoring/programs/new-contributor-workshop/resources/workspace-setup.md deleted file mode 100644 index 19dbef29..00000000 --- a/mentoring/programs/new-contributor-workshop/resources/workspace-setup.md +++ /dev/null @@ -1,24 +0,0 @@ -## Workspace Setup - -### Duration - -Plan for 90- 120 minutes of download and setup time when on wifi. When on a workshop specific network, this may be much shortened. - -### Task Overview - -Make sure all Beginning Contributors have a workspace setup for hacking on Kubernetes. - -**Important** Have facilitators to help with technical issues (3-5 for ~30 people) - -### Slides - -Clear and large download commands to copy into the terminal. - -### Details To Cover - -- Make sure everyone has the correct setup for a local build and test demo. - -### Ideas - -- Have a dedicated workshop network. -- When internet is slow, start the download and prep process during earlier sessions, to make sure everyone is up to date. diff --git a/mentoring/programs/new-contributor-workshop/videoguide.md b/mentoring/programs/new-contributor-workshop/videoguide.md deleted file mode 100644 index 2e96183f..00000000 --- a/mentoring/programs/new-contributor-workshop/videoguide.md +++ /dev/null @@ -1,131 +0,0 @@ -# Video Recording Guide for NCW2 DRAFT - - -## Introduction - - -## Setting up Your Video Environment - - -### Video - -The primary video in your NCW presentation will be screen-sharing, but it's also great if you can have some webcam segments. New contributors want to see the faces of current contributors. - - -#### Webcam Recording - -Use an external webcam. 1080p preferred or 720p at a minimum. Typically, either will be better quality than the built-in camera on your laptop. They often have an autofocus function and auto - -lighting adjustments that help you get a better camera feed in less than optimal lighting conditions. - -It’s best to optimize the ambient lighting within your space first. There should be no window or strong light source behind you that darkens your face and no strong light source from one side that casts a shadow on the opposite side of your face. Good ambient lighting from your ceiling lights or windows may be enough as long as they are in front of you. Diffused lighting is better than harsh, direct lighting. - - - - - -Webcam tips: - - - -* Background – keep it clean and uncluttered. It’s great to show off your personality/style in your home, just be sure to keep everything appropriate for a general audience and compliant with the Code of Conduct. A plain wall is also just fine, no need to overdo it. -* Position the camera as close as possible at your eye level, not pointing up towards your nose or the ceiling, or down towards the floor. It can be as simple as raising your laptop via a few books. Or if you have an external webcam, position it on the top edge or close to the top of the screen from which you are advancing your slides/notes. -* Keep eye contact with the camera just like you would look at your audience during an in-person presentation. -* Check [https://drive.google.com/drive/u/1/folders/1cvGcRgX9IWNR_csNVJ0nWRYD65Wmx9hu](https://drive.google.com/drive/u/1/folders/1cvGcRgX9IWNR_csNVJ0nWRYD65Wmx9hu) for virtual background images if you’d like to use them. - -Please, check the 4 minute video: [https://youtu.be/rGcAM1CNEU0](https://youtu.be/rGcAM1CNEU0) for more tips and examples. - - -#### Resolution - -Videos should ideally be recorded at 1080p or 720p if you’re using a video device, or at one of the following resolutions for screencasts: - - - -* 1440x1080 -* 1440x900 -* 1280x960 -* 1368x768 -* 1280x800 -* 1280x720 -* 1024x768 - -Particularly, do not record the video on the highest resolution your computer offers, such as 3200x1800. Such large screen sizes will make it difficult for folks with low bandwidth or older computers to view your broadcast. If you have a high-resolution screen on your computer, this may mean downgrading the resolution for screencasting. - - -### Audio - -Good audio is important. All recorded NCW segments have audio and this is the most important element that reinforces your presentation slides. In addition to software, you'll need hardware for recording audio. We realize that you don't necessarily have a chance to purchase or borrow the best audio equipment for an NCW video, but here's a few recommendations: - -**Best:** External microphone (condenser recommended over dynamic*) usually via a USB connection (e.g. Blue / Rhode / Razer brands). This type of microphone allows you to keep your mouth somewhat distant from the microphone, not up very close. You should try to keep it out of the video shot. - -**Good:** A headset with microphone, even if it’s earbud type with the mic on the lanyard. It’s about isolating microphone pick-up from ambient noises within your recording/streaming space. Input via USB or single mini-jack is typical or it can be dual minijack for older laptops/PCs. Cordless headsets also work, but it's better to use radio frequency dongles (RF) than bluetooth, which tends to produce sound quality issues. - -**Acceptable:** External microphone built into your webcam. Often better quality than your built-in laptop microphone. - -**Worst:** Your built-in laptop microphone. These are generally low-quality microphones, and they have little or no ability to filter out background noise. - -In general, it’s best to be in a controlled environment with little to no background noise and mute all other audio devices that are not necessary. - - - - -### Console Sessions - -Please, don’t forget to increase the font size when sharing a console. - - -## Recording Options and Instructions - - -### Zoom - - - -* Start a meeting in zoom (you can start and record a meeting with a single participant) -* Get the presentation slide setup with the screenshare. -* Once thats all setup click the record button -* when you click end meeting the video should export locally if you're doing the local record option -* Rename and copy mp4 file to google drive folder: [https://drive.google.com/drive/u/1/folders/1cvGcRgX9IWNR_csNVJ0nWRYD65Wmx9hu](https://drive.google.com/drive/u/1/folders/1cvGcRgX9IWNR_csNVJ0nWRYD65Wmx9hu) - - - -### Documentation and Exercises - - -### Where to Upload - -[https://drive.google.com/drive/u/1/folders/1cvGcRgX9IWNR_csNVJ0nWRYD65Wmx9hu](https://drive.google.com/drive/u/1/folders/1cvGcRgX9IWNR_csNVJ0nWRYD65Wmx9hu) - please upload all video files here. - - -## Tips - - -## Equipment Recommendations - -Here are some equipment recommendations from the CNCF: - -Headset Microphones: - -Logitech / Plantronics – i.e. Logitech H111 / Logitech H390 / Plantronics C225 - -External Microphones: - -Blue / Samson – i.e. Blue Snowball / Blue Yeti / Samson Meteor / Samson G-Track - -Webcams: - -Good value – Logitech C270 - -Value + added features – Logitech B525/C615 - -Higher resolution, better microphone – Logitech 9series / Microsoft LifeCam - -More info – https://www.tomsguide.com/news/where-to-buy-webcams-now-these-retailers-have-stock - -Presentation remotes: - -Logitech / Canon / Kensington / SMK - -Tested and recommended for PC or Mac – Logitech R400, R800, Spotlight / Canon PR500, PR100 - -- cgit v1.2.3 From 3b2ee98f42cf3225170e60a0e1e8c1d3251db8ce Mon Sep 17 00:00:00 2001 From: Alison Dowdney Date: Mon, 10 May 2021 20:39:48 +0100 Subject: Remove old new contributor workshop docs --- .../2020/03-contributor-summit/README.md | 13 -- .../2020/03-contributor-summit/content-proposal.md | 165 --------------------- .../2020/03-contributor-summit/runbook.md | 160 -------------------- 3 files changed, 338 deletions(-) delete mode 100644 mentoring/programs/contributor-workshop/2020/03-contributor-summit/README.md delete mode 100644 mentoring/programs/contributor-workshop/2020/03-contributor-summit/content-proposal.md delete mode 100644 mentoring/programs/contributor-workshop/2020/03-contributor-summit/runbook.md (limited to 'mentoring/programs') diff --git a/mentoring/programs/contributor-workshop/2020/03-contributor-summit/README.md b/mentoring/programs/contributor-workshop/2020/03-contributor-summit/README.md deleted file mode 100644 index 283fe402..00000000 --- a/mentoring/programs/contributor-workshop/2020/03-contributor-summit/README.md +++ /dev/null @@ -1,13 +0,0 @@ -## NCW Workshop Amsterdam - -## Team - -| Name & Handle | Role | Timezone | -|---------------|------|----------| -| | | | -| | | | -| | | | - -## Deadlines - -## Meeting Information diff --git a/mentoring/programs/contributor-workshop/2020/03-contributor-summit/content-proposal.md b/mentoring/programs/contributor-workshop/2020/03-contributor-summit/content-proposal.md deleted file mode 100644 index 93ea95d3..00000000 --- a/mentoring/programs/contributor-workshop/2020/03-contributor-summit/content-proposal.md +++ /dev/null @@ -1,165 +0,0 @@ -# Content Proposal for NCW Amsterdam - -## Introduction - -### 9:30 - 11:00 Intro Communications and Community -Alison, Rob, Rael, Josh: support/segment? - -Provide an overview on how the community works as a project both in terms of coordinating people and the special interest groups that those people participate in and the workflow that are used to accept new features, bug fixes. - -Note: Although these will have to be run separately, the content will be the same. - -## NCW Topics 101 - -This workshop will help a complete newcomer to Kubernetes get a running start as a contributor. Learn how to set up your developer environment, how to find your first contribution, and how to navigate the Kubernetes GitHub workflow. We will focus on a community approach to solving challenges, and on being good open source citizens. - -### Morning Session - -#### 11:00 - 12:00 [Workspace Setup](https://github.com/kubernetes/community/blob/master/events/events-team/content/new-contributor-workshops/workspace-setup.md) Tim & Rael - -Make sure all Beginning Contributors have a workspace setup for hacking on Kubernetes - -#### 12:00 - 12:30 [Local Build Test](https://github.com/kubernetes/community/blob/master/events/events-team/content/new-contributor-workshops/build-and-test.md) Tim & Rael -#### 13:30 - 14:00 [Local Build Test](https://github.com/kubernetes/community/blob/master/events/events-team/content/new-contributor-workshops/build-and-test.md) Tim & Rael - -Build Kubernetes binaries locally, and do some fun things with them. - -### Afternoon Sessions - -#### 14:00 - 14:45 [Pull Request Exercise](https://github.com/kubernetes/community/blob/master/events/events-team/content/new-contributor-workshops/playground-exercise.md) Guinevere, Rob - -Give new contributors the experience of the Kubernetes GitHub workflow! - -This task requires some setup and planning. Labels, Bots - -#### 14:45 - 15:15 [Find Your First Issue](https://github.com/kubernetes/community/blob/master/events/events-team/content/new-contributor-workshops/first-issue-help.md) Jeff - -Set participants on as much of a paved path to contributor success as possible. At this point in the workshop, participants should know what kind of issue they want to tackle. - -## NCW Topics 201 - -This workshop focuses on the **more experienced** open source contributor. You may have sent patches to Kubernetes before, but may have gotten stuck or overwhelmed somewhere along the line. Take your contributor journey to the next level by learning about the main Kubernetes code base, how to build and test Kubernetes, and how to find reviewers and collaborators for your issue patches. - -### Morning Session - -#### 11:00 - 12:00 K/K Walkthrough Alison - -Alison - -Guided tour of the main k/k repository, to build a broader understanding of how the codebase is structured - -#### 12:00 - 12:25 Labels, Bots and Git Workflow Guin & Rob - -In this session, we will cover how contributors interact with the kubernetes codebase on github. Join us as we dive into the Git Workflow used throughout the kubernetes project, including how Labels and Bots play a key role in managing issues and prs. - -### Afternoon Sessions - -#### 13:30 - 14:30 [Local Build & Test](https://github.com/kubernetes/community/blob/master/events/events-team/content/new-contributor-workshops/build-and-test.md) - 1hour ( Or Maybe More? ) Ben - -Build Kubernetes binaries locally, and do some fun things with them. - -#### 14:30 - 14:50 You! Yes you can review a PR! 15-20m Alison & Tim H - -In this session attendees will learn the in’s and outs of reviewing pull requests. We will go through a reviewing a pull request onstage, and provide some good starting points. - -#### 14:50 - 15:15 [Finding Your First Issue](https://github.com/kubernetes/community/blob/master/events/events-team/content/new-contributor-workshops/first-issue-help.md) / Closing Remarks 15m - -To close the Intermediate contributor workshop, The intermediate contributor workshop team will share their tips and tricks of finding a first issue, and stories of their first contributions. - -## Resources To Create - -* Capture who is presenting what - -* Slides to reflect the content proposal - -* Assign presenters for each section so presenters own their own slides - -* Docker Image Registry - - * Source Tree in a Docker Image incase of networking issues - - * [Sheet of what will be on the Harbor box](https://docs.google.com/spreadsheets/d/1_CUFluzIgeHt4vra9hs6OqBqDZQ8oUl9Og-IixkoEAM/edit?usp=sharing) - - * Add the needed container images, other binaries you want, and specific versions - -* Know before you go details - - * Instructions, What to install on your laptop, Sign the CLA - -* Can we link and update the handbooks here? Every presenter can update the handbooks as content matures! - -* On the day plan - More indepth dive of what happens - -### On The Day / Extra Notes -[runbook.md](runbook.md) - -### Handbooks -[../resources](../resources) - -### Slides -[https://docs.google.com/presentation/d/19OtCzuDTVeeIfMD39OOODGJzkV3UGM_nr7jpSNhoy2s/edit?ts=5e4b8bc8#slide=id.g52cc57d172_7_69](https://docs.google.com/presentation/d/19OtCzuDTVeeIfMD39OOODGJzkV3UGM_nr7jpSNhoy2s/edit?ts=5e4b8bc8#slide=id.g52cc57d172_7_69) - -## Slide Ideas - -* Solidify formatting for each type of slide - - * Code with instructions - - * Main Image - - * Image with text - - * Title Slides - - * Schedule Slides - -* Retro notes - Be a bit more creative with the slides, Do we want to do a direct copy paste of the slides from last time - -* From San Diego page -*Try to represent the journey of a contributor with the slides* - -* *Linking the key ideas themes, with walking along a brick road or similar. From cat to kubecat. *Or capybara to kubeybara - -* Break Slides - -* *Is a long presentation, adding a timeline at the bottom can help the attendees follow the presentation. This can go with the idea of showing the progress of the contributor as we move forward with the presentation. - I love this! -guin* - -## References - -San Diego Contributor Summit Content Proposal - -[https://docs.google.com/document/d/1ha3KtgLcRIY7IaRi9pm_h28xVsx9VoVLu8Fl1YO-eCI/edit?pli=1#heading=h.c2mvd8re7lpn](https://docs.google.com/document/d/1ha3KtgLcRIY7IaRi9pm_h28xVsx9VoVLu8Fl1YO-eCI/edit?pli=1#heading=h.c2mvd8re7lpn) - -Last years sched for san diego - -[https://kcsna2019.sched.com/](https://kcsna2019.sched.com/) - -Reference - -[https://github.com/kubernetes/community/blob/master/events/events-team/content/new-contributor-workshops/README.md](https://github.com/kubernetes/community/blob/master/events/events-team/content/new-contributor-workshops/README.md) - -## Virtual Event Go/No Go - -Alison: Go (speaking live) - -Jeff: Go (streaming/speaking live) - -Josh: Go (pre-record; virtual Q&A) - -Guin: Go (pre-record) - -James M: - -Rob: Go (Flexible; assign content ASAP) - -Chris Short: Go (shadow; streaming) - -Samudrala: Can present - -Nabarun: Can present - -Tim P: Can present (shadow) - -Rael: No Go - -Ben: No Go diff --git a/mentoring/programs/contributor-workshop/2020/03-contributor-summit/runbook.md b/mentoring/programs/contributor-workshop/2020/03-contributor-summit/runbook.md deleted file mode 100644 index 57369a71..00000000 --- a/mentoring/programs/contributor-workshop/2020/03-contributor-summit/runbook.md +++ /dev/null @@ -1,160 +0,0 @@ -# NCW On The Day Runbook / Extra Notes - -### 9:30 - 11:00 Intro Communications and Community -Alison, Rob, Rael, Josh: support/segment? - -Sections - -* Welcome & PR Demo [Slide 6](https://docs.google.com/presentation/d/19OtCzuDTVeeIfMD39OOODGJzkV3UGM_nr7jpSNhoy2s/edit#slide=id.g64b51f6423_1_0) - -* Why Contribute / Origin Story [Slide 10](https://docs.google.com/presentation/d/19OtCzuDTVeeIfMD39OOODGJzkV3UGM_nr7jpSNhoy2s/edit#slide=id.g5e6254b17b_4_1168) - - * Why - - * Origin Story - - * Choose your adventure - - * Find your topic - -* Communications [Slide 13](https://docs.google.com/presentation/d/19OtCzuDTVeeIfMD39OOODGJzkV3UGM_nr7jpSNhoy2s/edit#slide=id.g5e6254b17b_4_1185) - - * How we communicate - - * Standards - - * Asking tech Q’s - -* Community Groups/Organization/SIG Tour: Josh? [Slide 29](https://docs.google.com/presentation/d/19OtCzuDTVeeIfMD39OOODGJzkV3UGM_nr7jpSNhoy2s/edit#slide=id.g5e6254b17b_4_1266) - -* Repo Tour: Samudrala [Slide 52](https://docs.google.com/presentation/d/19OtCzuDTVeeIfMD39OOODGJzkV3UGM_nr7jpSNhoy2s/edit#slide=id.g645f82e308_0_17) - -* How to find what you need: Alison [Slide 55](https://docs.google.com/presentation/d/19OtCzuDTVeeIfMD39OOODGJzkV3UGM_nr7jpSNhoy2s/edit#slide=id.g7eae03886b_2_18) - - * https://cs.k8s.io/ - -Josh: I can take any of the above that someone else doesn't want. - -#### Notes and cool ideas - -#### Communications Tools - -Discuss, Slack, Mailing List, Github, Twitter - -#### Kubernetes Podcasts - -#### Periodic Meetings - -Office Hours, Community Meeting - -#### Scavenger Hunt - -Register in k8s slack, post a Hi to the New Contributor Workshop Room - -Post a commit made by Joe Beda that contains a TODO to a special NCW Amsterdam discuss Thread. Oldest TODO wins. - -Find and favorite a NCW Easter Egg post in the NCW Amsterdam room - -Find and heart a k8s First Good Issue on Github - -#### -Main content - -Live PR Demo - -Paths to Contributorship - -Communication in the Kubernetes Community - -Community Group and Governance - -Orgs Overview - -How to find what you need in the community - -Tips and tricks to interact with the community -Teach people to answer their own questions - -[cs.k8s.io](https://cs.k8s.io/) - -How to phrase questions - -Limitations of GitHub searches - -Traversing K8s docs - -List speakers and roles for each section - -## NCW Topics 101 - -### 11:00 - 12:00 [Workspace Setup](https://github.com/kubernetes/community/blob/master/events/events-team/content/new-contributor-workshops/workspace-setup.md) Tim & Rael - -**Make sure all Beginning Contributors have a workspace setup for hacking on Kubernetes** - -### 12:00 - 12:30 [Local Build Test](https://github.com/kubernetes/community/blob/master/events/events-team/content/new-contributor-workshops/build-and-test.md) Tim & Rael - -### 13:30 - 14:00 [Local Build Test](https://github.com/kubernetes/community/blob/master/events/events-team/content/new-contributor-workshops/build-and-test.md) **Tim & Rael** - -**Build Kubernetes binaries locally, and do some fun things with them.** - -### 14:00 - 14:45 [Pull Request Exercise](https://github.com/kubernetes/community/blob/master/events/events-team/content/new-contributor-workshops/playground-exercise.md) **Guinevere, Rob** - -**Give new contributors the experience of the Kubernetes GitHub workflow! ** - -**This task requires some setup and planning. Labels, Bots** - -### 14:45 - 15:15 [Find Your First Issue](https://github.com/kubernetes/community/blob/master/events/events-team/content/new-contributor-workshops/first-issue-help.md) **Jeff** - -Set participants on as much of a paved path to contributor success as possible. At this point in the workshop, participants should know what kind of issue they want to tackle. - -## NCW Topics 201 - -### Morning Session - -### K/K Walkthrough 11:00 - 12:00 - -Alison - -Guided tour of the main k/k repository, to build a broader understanding of how the codebase is structured - -### Labels, Bots and Git Workflow 12:00 - 12:25 - -Guin & Rob - -In this session, we will cover how contributors interact with the kubernetes codebase on github. Join us as we dive into the Git Workflow used throughout the kubernetes project, including how Labels and Bots play a key role in managing issues and prs. - -### Afternoon Sessions - -### [Local Build & Test](https://github.com/kubernetes/community/blob/master/events/events-team/content/new-contributor-workshops/build-and-test.md) - 1hour ( Or Maybe More? ) 13:30 - 14:30 - -Ben - -Build Kubernetes binaries locally, and do some fun things with them. - -* Live workshop - -* This part can be really flexible - -* Walkthrough workspace set up - -* Step-by-step DevProcess - -* Fun with Go and Kind cluster ( some previous examples) - -* Resolving set up issues - -* Could we do something else here? - -* Modify a controllers behavior - -### You! Yes you can review a PR! 15-20m 14:30 - 14:50 - -Alison? With help from Tim -Look at Tim’s talk from SD - -In this session attendees will learn the in’s and outs of reviewing pull requests. We will go through a reviewing a pull request onstage, and provide some good starting points. - -### [Finding Your First Issue](https://github.com/kubernetes/community/blob/master/events/events-team/content/new-contributor-workshops/first-issue-help.md) / Closing Remarks 15m 14:50 - 15:15 - -To close the Intermediate contributor workshop, The intermediate contributor workshop team will share their tips and tricks of finding a first issue, and stories of their first contributions. - -- cgit v1.2.3 From 3cf16a53d47fb475980e06399ffd93c8b8a15f13 Mon Sep 17 00:00:00 2001 From: Alison Dowdney Date: Tue, 11 May 2021 01:29:28 +0100 Subject: Revamp Contributor Workshop resources In line with moving the contributor workshop to a self paced course, we need to provide resources on how to contribute and update the workshop. * Update the Video Guide * Create Guide on how to add segments to the workshop * Create a Glossary to define repeated verbalage * Outline how the workshop is structured * Create template for segments * Move exisitng resources for running live NCW to live-workshop --- mentoring/programs/contributor-workshop/README.md | 27 +- .../contributor-workshop/resources/README.md | 42 +-- .../resources/build-and-test.md | 27 -- .../resources/community-groups.md | 27 -- .../resources/contributor-paths.md | 26 -- .../resources/first-issue-help.md | 31 -- .../resources/guides/README.md | 35 ++ .../resources/guides/presenterexitfullscreen.png | Bin 0 -> 37848 bytes .../resources/guides/presenterfullscreen.png | Bin 0 -> 52239 bytes .../resources/guides/presenterview.png | Bin 0 -> 33964 bytes .../resources/guides/presenterviewandslides.png | Bin 0 -> 638041 bytes .../resources/guides/presenterwindowed.png | Bin 0 -> 28083 bytes .../resources/guides/slidesnotabs.png | Bin 0 -> 240719 bytes .../resources/guides/slideswithtabs.png | Bin 0 -> 495569 bytes .../resources/guides/updating-segment.md | 57 +++ .../resources/guides/videoguide.md | 397 +++++++++++++++++++++ .../resources/how-we-communicate.md | 33 -- .../resources/labels-and-bots.md | 25 -- .../contributor-workshop/resources/live-pr-demo.md | 24 -- .../resources/live-workshop/README.md | 39 ++ .../resources/live-workshop/build-and-test.md | 27 ++ .../resources/live-workshop/community-groups.md | 27 ++ .../resources/live-workshop/contributor-paths.md | 26 ++ .../resources/live-workshop/first-issue-help.md | 31 ++ .../resources/live-workshop/how-we-communicate.md | 33 ++ .../resources/live-workshop/labels-and-bots.md | 25 ++ .../resources/live-workshop/live-pr-demo.md | 24 ++ .../live-workshop/new-contributor-workshop-lead.md | 54 +++ .../resources/live-workshop/playground-exercise.md | 28 ++ .../resources/live-workshop/repo-tour.md | 24 ++ .../resources/live-workshop/workspace-setup.md | 24 ++ .../resources/new-contributor-workshop-lead.md | 54 --- .../resources/playground-exercise.md | 28 -- .../contributor-workshop/resources/repo-tour.md | 24 -- .../resources/templates/segment-template.md | 33 ++ .../resources/workspace-setup.md | 24 -- .../programs/contributor-workshop/videoguide.md | 131 ------- 37 files changed, 911 insertions(+), 496 deletions(-) delete mode 100644 mentoring/programs/contributor-workshop/resources/build-and-test.md delete mode 100644 mentoring/programs/contributor-workshop/resources/community-groups.md delete mode 100644 mentoring/programs/contributor-workshop/resources/contributor-paths.md delete mode 100644 mentoring/programs/contributor-workshop/resources/first-issue-help.md create mode 100644 mentoring/programs/contributor-workshop/resources/guides/README.md create mode 100644 mentoring/programs/contributor-workshop/resources/guides/presenterexitfullscreen.png create mode 100644 mentoring/programs/contributor-workshop/resources/guides/presenterfullscreen.png create mode 100644 mentoring/programs/contributor-workshop/resources/guides/presenterview.png create mode 100644 mentoring/programs/contributor-workshop/resources/guides/presenterviewandslides.png create mode 100644 mentoring/programs/contributor-workshop/resources/guides/presenterwindowed.png create mode 100644 mentoring/programs/contributor-workshop/resources/guides/slidesnotabs.png create mode 100644 mentoring/programs/contributor-workshop/resources/guides/slideswithtabs.png create mode 100644 mentoring/programs/contributor-workshop/resources/guides/updating-segment.md create mode 100644 mentoring/programs/contributor-workshop/resources/guides/videoguide.md delete mode 100644 mentoring/programs/contributor-workshop/resources/how-we-communicate.md delete mode 100644 mentoring/programs/contributor-workshop/resources/labels-and-bots.md delete mode 100644 mentoring/programs/contributor-workshop/resources/live-pr-demo.md create mode 100644 mentoring/programs/contributor-workshop/resources/live-workshop/README.md create mode 100644 mentoring/programs/contributor-workshop/resources/live-workshop/build-and-test.md create mode 100644 mentoring/programs/contributor-workshop/resources/live-workshop/community-groups.md create mode 100644 mentoring/programs/contributor-workshop/resources/live-workshop/contributor-paths.md create mode 100644 mentoring/programs/contributor-workshop/resources/live-workshop/first-issue-help.md create mode 100644 mentoring/programs/contributor-workshop/resources/live-workshop/how-we-communicate.md create mode 100644 mentoring/programs/contributor-workshop/resources/live-workshop/labels-and-bots.md create mode 100644 mentoring/programs/contributor-workshop/resources/live-workshop/live-pr-demo.md create mode 100644 mentoring/programs/contributor-workshop/resources/live-workshop/new-contributor-workshop-lead.md create mode 100644 mentoring/programs/contributor-workshop/resources/live-workshop/playground-exercise.md create mode 100644 mentoring/programs/contributor-workshop/resources/live-workshop/repo-tour.md create mode 100644 mentoring/programs/contributor-workshop/resources/live-workshop/workspace-setup.md delete mode 100644 mentoring/programs/contributor-workshop/resources/new-contributor-workshop-lead.md delete mode 100644 mentoring/programs/contributor-workshop/resources/playground-exercise.md delete mode 100644 mentoring/programs/contributor-workshop/resources/repo-tour.md create mode 100644 mentoring/programs/contributor-workshop/resources/templates/segment-template.md delete mode 100644 mentoring/programs/contributor-workshop/resources/workspace-setup.md delete mode 100644 mentoring/programs/contributor-workshop/videoguide.md (limited to 'mentoring/programs') diff --git a/mentoring/programs/contributor-workshop/README.md b/mentoring/programs/contributor-workshop/README.md index c0ebd557..535eee33 100644 --- a/mentoring/programs/contributor-workshop/README.md +++ b/mentoring/programs/contributor-workshop/README.md @@ -1,8 +1,27 @@ -# NCW Workshops +# Contributor Workshop -## Upcoming Workshops +## Overview -None scheduled +The Contributor Workshop is a self paced course on the contributor site, aimed at both new and existing contributors. -## Previous Workshops +Previously this workshop was run as a live in person session, as part of the Kubernetes Contributor Summit. With many changes brought upon in 2020, we decided to change the format to a self paced course. + +## Status + +The Contributor Workshop is currently in development, and has not been released to the public. + +You can view the live state of the site by going to [https://workshop--kubernetes-contributor.netlify.app/docs/workshop/](https://workshop--kubernetes-contributor.netlify.app/docs/workshop/) + +The umbrella issue tracking getting this initiative available to the public is [#4830 in kubernetes/community](https://github.com/kubernetes/community/issues/4830). + +## Getting Involved + +* Read the guides on contributing to the Contributor Workshop +[Contributing to the Contributor Workshop](resources/guides/README.md) + +* Attend the bi-weekly mentoring meeting + +* Join the discussion in #contributor-workshop-dev on Kubernetes Slack + +## Previous Live Workshops * [2019 NA Contributor Summit NCW](https://www.youtube.com/watch?v=uUJrGwAom-E&list=PL69nYSiGNLP0OWp38tPBc-jSlMmwWr6Ci&index=16) (Videos in playlist, links to first NCW video) diff --git a/mentoring/programs/contributor-workshop/resources/README.md b/mentoring/programs/contributor-workshop/resources/README.md index 917fb5a0..74356ac1 100644 --- a/mentoring/programs/contributor-workshop/resources/README.md +++ b/mentoring/programs/contributor-workshop/resources/README.md @@ -1,40 +1,6 @@ -# New Contributor Workshops Resources +# Contributor Workshop Resources +This folder contains information on -## Overview - -This folder contains the [handbook for the New Contributor Workshop Content Lead](./new-contributor-workshop-lead.md) as well as playbooks for each of the New Contributor Workshop sessions. - -This workshop is held periodically by the Kubernetes Community, but materials and processes may be used at contributor focused summits and events anywhere. - -Slides from previous New Contributor Workshops can be found [here](https://github.com/cncf/presentations/blob/master/kubernetes/README.md#kubernetes-new-contributor-workshops). - -## Sample Track for Beginner Workshop - -This workshop is meant for folks who have never contributed to opensource before and/or need help setting up a Kubernetes developer environment. - -1. Welcome -1. [Live PR Demo](./live-pr-demo.md) -1. [Paths to Contributorship](./contributor-paths.md) -1. [Communication in the Kubernetes Community](./how-we-communicate.md) -1. [Community Group and Governance Overview](./community-groups.md) -1. [Kubernetes Orgs Overview](./repo-tour.md) -1. [Workspace Setup](./workspace-setup.md) -1. [Local Build&Test](./build-and-test.md) -1. [Pull Request Exercise](./playground-exercise.md) -1. [Find Your First Issue](./first-issue-help.md) - -## Sample Track for Intermediate Workshop - -This workshop differs from the Beginner workshop in that participants are expected to have a working Docker/Kubernetes/Go setup. They have a basic understanding of how opensource contributions work, and may have opened a PR against Kubernetes before. - -1. Welcome -1. [Live PR Demo](./live-pr-demo.md) -1. [Paths to Contributorship](./contributor-paths.md) -1. [Communication in the Kubernetes Community](./how-we-communicate.md) -1. [Community Group and Governance Overview](./community-groups.md) -1. [Kubernetes Orgs Overview](./repo-tour.md) -1. k/k Walkthrough -1. [Local Build&Test](./build-and-test.md) -1. [Labels, Bots and Git Workflow](./labels-and-bots.md) -1. [Find Your First Issue](./first-issue-help.md) +- How to contribute to the Contributor Workshop site +- How to run a "live" Contributor Workshop (see [``live-workshop``](live-workshop/README.md)) \ No newline at end of file diff --git a/mentoring/programs/contributor-workshop/resources/build-and-test.md b/mentoring/programs/contributor-workshop/resources/build-and-test.md deleted file mode 100644 index 147d91a3..00000000 --- a/mentoring/programs/contributor-workshop/resources/build-and-test.md +++ /dev/null @@ -1,27 +0,0 @@ -## Build and Test - -### Duration - -40-60 minutes, depending on beginner vs intermediate participants - -### Task Overview - -Build Kubernetes binaries locally, and do some fun things with them. - -**Important** Have facilitators to help with technical issues (2-3 is enough for Intermediate, you want 5 for Beginner) - -### Slides - -Clear command line instructions. - -### Details To Cover - -- This is the hands-on part. Details are up to you; look to previous workshops for inspiration. -- Adjust difficulty based on whether this is the Beginner or Intermediate workshop. -- It is _extremely important_ to run this part of the workshop several times previously, and to make sure that versions match those in the [workspace setup](./workspace-setup.md). - -### Ideas - -- Do a fun thing with the Kubernetes [go client](https://git.k8s.io/client-go) and a [kind](https://sigs.k8s.io/kind) cluster. -- Build and modify `kubectl`. -- Try a `make` command; be aware you may need to give docker a lot of space on your machine for a successful build. diff --git a/mentoring/programs/contributor-workshop/resources/community-groups.md b/mentoring/programs/contributor-workshop/resources/community-groups.md deleted file mode 100644 index 01a8c80c..00000000 --- a/mentoring/programs/contributor-workshop/resources/community-groups.md +++ /dev/null @@ -1,27 +0,0 @@ -## Community Groups - -### Duration - -15 minutes - -### Task Overview - -Introduce SIGs, Working Groups, and a tiny bit of governance (if you must). - -### Slides - -Refer to previous workshops for inspirations. - -### Details To Cover - -- SIGs -- Subprojects -- Working Groups -- User Groups -- Committees -- How to Join Any Of The Above - -### Ideas - -- Stay simple. Don't make it too complicated. -- Ask participants to define a few example SIGs via audience interaction. \ No newline at end of file diff --git a/mentoring/programs/contributor-workshop/resources/contributor-paths.md b/mentoring/programs/contributor-workshop/resources/contributor-paths.md deleted file mode 100644 index d14691eb..00000000 --- a/mentoring/programs/contributor-workshop/resources/contributor-paths.md +++ /dev/null @@ -1,26 +0,0 @@ -## Contributor Paths - -### Duration - -10-30 minutes - -### Task Overview - -This is about contributor origin stories. - -### Slides - -Refer to previous workshops for inspirations - -### Details To Cover - -- Who can contribute? -- What skills are needed? -- How to Fit Contributions Into Your Job -- Balance knowledge with learning and the needs of the project - -### Ideas - -- Share some contributor origin stories -- Ask the room why they are at the workshop -- Have a few people share their thoughts diff --git a/mentoring/programs/contributor-workshop/resources/first-issue-help.md b/mentoring/programs/contributor-workshop/resources/first-issue-help.md deleted file mode 100644 index b99488af..00000000 --- a/mentoring/programs/contributor-workshop/resources/first-issue-help.md +++ /dev/null @@ -1,31 +0,0 @@ -## Finding Your First Issue - -### Duration - -20 minutes - -### Task Overview - -Set participants on as much of a paved path to contributor success as possible. -At this point in the workshop, participants should know what kind of issue they want to tackle. - -### Slides - -Refer to previous workshops for inspirations - -### Details To Cover - -- help-wanted and good-first-issue labels -- Up and coming sandbox projects -- Working with your SIG -- Refer participants to specific SIGs -- How to "claim" an issue (since non-members cannot self-assign) -- Path to [membership](/community-membership.md) - -### Ideas - -- Give folks time to discuss and help each other -- Gather information from SIGs in advance (via Slack, Twitter...) on who needs help, and at what level -- Prepare a list of issues and assign folks right there -- Connect participants to mentoring tracks if available (e.g. Release Team Shadow) - diff --git a/mentoring/programs/contributor-workshop/resources/guides/README.md b/mentoring/programs/contributor-workshop/resources/guides/README.md new file mode 100644 index 00000000..d0db193d --- /dev/null +++ b/mentoring/programs/contributor-workshop/resources/guides/README.md @@ -0,0 +1,35 @@ +# Contributing to the Contributor Workshop + +## Overview + +This folder contains guides and information on how to contribute to the Contributor Workshop. + +## Workshop Structure + +The workshop is divided into segments. These segments exist as individual pages in the ``content/en/docs/workshop`` directory on the branch ``workshop`` in the ``contributor-site`` repo. + +Each of these segments contain +* Written information +* One or more Exercises +and may contain a video version of the written information. + +## Guides + +### [Updating & Creating Segments](updating-segment.md) + +How to update and create segments on the contributor site + +### [Video Recording Guide for Contributor Workshop Segments](videoguide.md) + +How to structure, record, upload and update video guides associated with workshop segments. + +## Glossary of Terms + +Segment + A page in the workshop directory covering a particular section of the Contributor Workshop. + This page may contain + * Written information + * Video version of the segment + * Hands on exercise +Exercise + Step by step, hands on activity within a segment. \ No newline at end of file diff --git a/mentoring/programs/contributor-workshop/resources/guides/presenterexitfullscreen.png b/mentoring/programs/contributor-workshop/resources/guides/presenterexitfullscreen.png new file mode 100644 index 00000000..0752c73f Binary files /dev/null and b/mentoring/programs/contributor-workshop/resources/guides/presenterexitfullscreen.png differ diff --git a/mentoring/programs/contributor-workshop/resources/guides/presenterfullscreen.png b/mentoring/programs/contributor-workshop/resources/guides/presenterfullscreen.png new file mode 100644 index 00000000..8a6b81cb Binary files /dev/null and b/mentoring/programs/contributor-workshop/resources/guides/presenterfullscreen.png differ diff --git a/mentoring/programs/contributor-workshop/resources/guides/presenterview.png b/mentoring/programs/contributor-workshop/resources/guides/presenterview.png new file mode 100644 index 00000000..252c25df Binary files /dev/null and b/mentoring/programs/contributor-workshop/resources/guides/presenterview.png differ diff --git a/mentoring/programs/contributor-workshop/resources/guides/presenterviewandslides.png b/mentoring/programs/contributor-workshop/resources/guides/presenterviewandslides.png new file mode 100644 index 00000000..f3e88d60 Binary files /dev/null and b/mentoring/programs/contributor-workshop/resources/guides/presenterviewandslides.png differ diff --git a/mentoring/programs/contributor-workshop/resources/guides/presenterwindowed.png b/mentoring/programs/contributor-workshop/resources/guides/presenterwindowed.png new file mode 100644 index 00000000..653d76ce Binary files /dev/null and b/mentoring/programs/contributor-workshop/resources/guides/presenterwindowed.png differ diff --git a/mentoring/programs/contributor-workshop/resources/guides/slidesnotabs.png b/mentoring/programs/contributor-workshop/resources/guides/slidesnotabs.png new file mode 100644 index 00000000..1b41c84b Binary files /dev/null and b/mentoring/programs/contributor-workshop/resources/guides/slidesnotabs.png differ diff --git a/mentoring/programs/contributor-workshop/resources/guides/slideswithtabs.png b/mentoring/programs/contributor-workshop/resources/guides/slideswithtabs.png new file mode 100644 index 00000000..e82882a2 Binary files /dev/null and b/mentoring/programs/contributor-workshop/resources/guides/slideswithtabs.png differ diff --git a/mentoring/programs/contributor-workshop/resources/guides/updating-segment.md b/mentoring/programs/contributor-workshop/resources/guides/updating-segment.md new file mode 100644 index 00000000..7f9aba1c --- /dev/null +++ b/mentoring/programs/contributor-workshop/resources/guides/updating-segment.md @@ -0,0 +1,57 @@ +# Updating workshop segments + +This guide covers how to update segments in the Contributor Workshop. + +- [Updating workshop segments](#updating-workshop-segments) + - [Prerequisites](#prerequisites) + - [Fork & Clone the ``contributor-site``](#fork--clone-the-contributor-site) + - [Checkout a branch off the workshop branch for your changes](#checkout-a-branch-off-the-workshop-branch-for-your-changes) + - [Run the site locally with your changes](#run-the-site-locally-with-your-changes) + - [Modifying an existing segment](#modifying-an-existing-segment) + - [Adding a segment to the workshop](#adding-a-segment-to-the-workshop) + - [Adding a video guide to accompany a segment](#adding-a-video-guide-to-accompany-a-segment) + - [Save, Commit, Push, PR](#save-commit-push-pr) + +## Prerequisites + +### Fork & Clone the ``contributor-site`` + +Create a fork of the [``contributor-site``](https://github.com/kubernetes/contributor-site/tree/workshop) repo. + +Clone your fork locally + +### Checkout a branch off the workshop branch for your changes + +```bash +git checkout workshop + +git checkout -b my-changes +``` + +### Run the site locally with your changes + +Follow the instructions in the top level [``README.md``](https://github.com/kubernetes/contributor-site/tree/master/README.md#running-the-site-locally) on the contributor-site. + +You're now ready to update and add segments! + +## Modifying an existing segment + +Find the file you would like to edit and open it. See [the list of segments](https://github.com/kubernetes/contributor-site/tree/workshop/content/en/workshop/CONTRIBUTING.md#list-of-segments). + +## Adding a segment to the workshop + +Make sure to update [the list of segments](https://github.com/kubernetes/contributor-site/tree/workshop/content/en/workshop/CONTRIBUTING.md#list-of-segments), with the new page. + +If inserting a page between existing pages, make sure to update the page weightings in the frontmatter and [the list of segments](https://github.com/kubernetes/contributor-site/tree/workshop/content/en/workshop/CONTRIBUTING.md#list-of-segments),. + +See [the segment template](../templates/segment-template.md), on how to structure your segment. + +## Adding a video guide to accompany a segment + +With some of the guides, we might want a youtube video to accompany them. You can find the information for adding a video to the guide, in the [video guide](videoguide.md) + +## Save, Commit, Push, PR + +Once you've made the modifications and additions you want, commit and push them to your fork. + +Then make a pull request of your changes into the ``workshop`` branch of the ``contributor-site`` repo. \ No newline at end of file diff --git a/mentoring/programs/contributor-workshop/resources/guides/videoguide.md b/mentoring/programs/contributor-workshop/resources/guides/videoguide.md new file mode 100644 index 00000000..d9973c92 --- /dev/null +++ b/mentoring/programs/contributor-workshop/resources/guides/videoguide.md @@ -0,0 +1,397 @@ +# Video Recording Guide for Contributor Workshop Segments + +This guide covers, how to structure, record, upload and update video guides associated with workshop segments. + +- [Video Recording Guide for Contributor Workshop Segments](#video-recording-guide-for-contributor-workshop-segments) + - [Format / Video Style](#format--video-style) + - [Encoding Guidelines](#encoding-guidelines) + - [Zoom Recording](#zoom-recording) + - [OBS](#obs) + - [Streamyard](#streamyard) + - [Adobe Media Encoder](#adobe-media-encoder) + - [Recording Guides](#recording-guides) + - [Recording in Zoom](#recording-in-zoom) + - [Install Windowed extension (optional)](#install-windowed-extension-optional) + - [Start the meeting](#start-the-meeting) + - [Setting up slides for recording](#setting-up-slides-for-recording) + - [Without browser extension](#without-browser-extension) + - [With browser extension](#with-browser-extension) + - [Note : Exiting the windowed mode](#note--exiting-the-windowed-mode) + - [Adding your facecam](#adding-your-facecam) + - [Unmute your audio](#unmute-your-audio) + - [Recording in Zoom](#recording-in-zoom-1) + - [Note : Do a test recording first](#note--do-a-test-recording-first) + - [How to record](#how-to-record) + - [Recording in OBS](#recording-in-obs) + - [Recording in Streamyard](#recording-in-streamyard) + - [Updating / Adding video to a segment](#updating--adding-video-to-a-segment) + - [Rename your recording](#rename-your-recording) + - [Update Google Drive](#update-google-drive) + - [Uploading your video](#uploading-your-video) + - [What folder to upload to](#what-folder-to-upload-to) + - [Updating Youtube](#updating-youtube) + - [Upload the new video](#upload-the-new-video) + - [Adding the thumbnail image](#adding-the-thumbnail-image) + - [Setting the description](#setting-the-description) + - [Update the previous video for the segment if it exists](#update-the-previous-video-for-the-segment-if-it-exists) + - [Update the title](#update-the-title) + - [Update the thumbnail image](#update-the-thumbnail-image) + - [Update the Description](#update-the-description) + - [Update the Comments](#update-the-comments) + - [Updating the Segment page with video](#updating-the-segment-page-with-video) + - [Best Practices & Recommendations](#best-practices--recommendations) + - [Video](#video) + - [Camera Type](#camera-type) + - [Audio](#audio) + - [Microphone Types](#microphone-types) + - [Sound Environment](#sound-environment) + - [Background Noise](#background-noise) + - [Other Tips](#other-tips) + - [Screensharing](#screensharing) + - [Hardware](#hardware) + - [Headset Microphones](#headset-microphones) + - [External Microphones](#external-microphones) + - [Webcams](#webcams) + - [Presentation remotes](#presentation-remotes) + +## Format / Video Style + +You can use any format/style as long as the same information in the guide is captured in the video. Slides, A screenshare, greenscreen yourself into the repo even! Be creative. + +## Encoding Guidelines + +### Zoom Recording +Handled by zoom, Can't change these settings. + +### OBS +(todo : match with media encoder) +type : standard +recording format : mp4 +encoder: x264 +rescale: 1920x1080 +rate control : VBR +bitrate : 16000kbps +CRF : ??? + +### Streamyard +Handled by Streamyard, Can't change these settings. + +### Adobe Media Encoder +use Youtube 1080p Full HD + +## Recording Guides + +Guides on how to record a presentation style video (slides/screen,facecam) + +### Recording in Zoom + +#### Install Windowed extension (optional) +This makes it easier for you to share the slides to zoom. Allows you to pop out the fullscreen view to a single window. + +[GitHub Link](https://github.com/dralletje/Windowed) + +#### Start the meeting + +Start a meeting in zoom (you can start and record a meeting with a single participant) + +#### Setting up slides for recording + +Open your slides in Presenter View +![Presenter View](presenterview.png) + +It should open a presenter view, with a timer, slide notes, and change the tab from editor to a slideshow presentation + +![Presenter View and Slides](presenterviewandslides.png) + +You will use the presenter view to control the slides, and the slide view will be cast to the zoom call. + +##### Without browser extension + +Share the window which is displaying the slides view. + +![Slides with your tabs](slideswithtabs.png) + +##### With browser extension + +When moving your mouse on the slide view a small dialog with the slide number, and triple dots will appear. Select the triple dots and enter full screen + +![Enter Full Screen on Presentation](presenterfullscreen.png) + +After selecting the fullscreen option, you will be presented further options on how to display the slides. + +Select the windowed option + +![Windowed Fullscreen](presenterwindowed.png) + +A new window with only the slides will appear, Share this window in zoom. + +![Slides with no tabs](slidesnotabs.png) + +###### Note : Exiting the windowed mode + +To exit out of this view, and go back the editor, select the window with the slide view back into focus, move your mouse until the triple dots mentioned earlier appear. Select the triple dots again and ``Exit Full Screen`` + +![Exit Full Screen](presenterexitfullscreen.png) + +#### Adding your facecam + +If you haven't done so already, start your video in Zoom. + +#### Unmute your audio + +If you haven't done so already, unmute your audio in Zoom. + +#### Recording in Zoom + +Now that you've got your slides, video and audio setup, you're ready to record! + +##### Note : Do a test recording first + +It's good practice to create a test recording of your whole setup in action. +If you change shares between windows, check that changing the shares appears how you want it to in the video. + +##### How to record + +Select the ``Record`` button in zoom. + +If you have the option between saving locally, and in the cloud, select locally. + +Once you have finished recording, end the meeting. + +A popup should appear with progress on converting the recording. +Once the recording is converted, a file browser window with the recording will be opened. Rename the recording from ``zoom_0.mp4`` to the format described in [Rename your recording](#rename-your-recording) + +### Recording in OBS + +Coming soon + +### Recording in Streamyard + +Coming soon + +## Updating / Adding video to a segment + +### Rename your recording + +Rename your recording to ``YYYY-MM-DD--.mp4`` + +Where +* ``YYYY-MM-DD`` being date, is the date video was recorded +* ```` being the name of the markdown file associated with that segment. see [CONTRIBUTING.md](https://github.com/kubernetes/contributor-site/tree/workshop/content/en/workshop/CONTRIBUTING.md#list-of-segments) +* ```` being the github handle of the person who recorded the video, if there are multiple presenters just add another dash and the handle. ``-`` + +For example + +``2021-05-10-why-contribute-alisondy.mp4`` +``2021-05-10-why-contribute-alisondy-mrbobbytables.mp4`` + +### Update Google Drive + +#### Uploading your video + +You will upload your recording to the folder associated with your segment. More details in [What folder to upload to](#what-folder-to-upload-to) + +##### What folder to upload to +There should be a folder for your segment. If one doesn't exist, create a new one with the segment name. + +segment name being the name of the markdown file associated with that segment. see [CONTRIBUTING.md](https://github.com/kubernetes/contributor-site/tree/workshop/content/en/workshop/CONTRIBUTING.md#list-of-segments) + +For example + +``why-contribute`` + +### Updating Youtube + +Once you have uploaded the video to drive, upload it to youtube, and update the previous recording on youtube ( if any ) + +#### Upload the new video + +In youtube, upload the same video and title it as follows + +```txt +Contributor Workshop : with | +``` + +For example + +```txt +Contributor Workshop : Why Contribute? with @alisondy | May 2021 +``` + +##### Adding the thumbnail image + +```markdown +TODO : Instructions on how to generate a thumbnail image, similar to https://gist.github.com/alisondy/e4ff3b483a32330ade0c880b4a4a10b1 +``` + +Set the thumbnail to the image generated in the previous step + +##### Setting the description + +Use the following template for setting the video description + +```txt +This is the video guide for the Contributor Workshop segment + +Link to this segments page: +https://kubernetes.dev/docs/workshop/ + +Link to the workshop: +https://kubernetes.dev/docs/workshop/ +``` + +#### Update the previous video for the segment if it exists + +If you're updating an already existing video, follow the next steps to update the following on the previous video +- title +- thumbnail +- description +- comments section + +##### Update the title +Update the title on the previous video to match the following format + +```txt +Contributor Workshop : | | 🚨🚨 DEPRECATED 🚨🚨 +``` + +For example + +```txt +Contributor Workshop : Why Contribute? with @alisondy | May 2021 | 🚨🚨 DEPRECATED 🚨🚨 +``` + +##### Update the thumbnail image + +Update the Thumbnail image on the previous video to + +insert-deprecation-thumbnail-here.jpeg +```txt + + +THIS VIDEO IS DEPRECATED! +See the comments & description for details on where to find the new video guide! + + +``` + +##### Update the Description + +On the previous video, add the following to the start of the description +```txt +🚨🚨 DEPRECATED , Please see 🚨🚨 +``` + +##### Update the Comments + +On the previous video, add the following as a comment as Kubernetes YT & pin to the top of the comments + +```txt +🚨🚨 DEPRECATED , Please see 🚨🚨 +``` + +Close the comment section of the deprecated video + +#### Updating the Segment page with video + +If adding to a segment page where video doesn't exist, Paste this at the top, after the frontmatter. Fill in the details with the youtube id of the video you just uploaded. + +If adding to a segment page where a video already exists, update the youtube id in the shortcode, with the video id of your newly uploaded video. + +```txt +## Video Walkthrough + +{{< youtube id="" title="Contributor Workshop : }} +``` + +## Best Practices & Recommendations + +### Video + +#### Camera Type +Use an external camera or webcam to capture your video. + +Built in webcams restrict the angle of you webcam, to the viewing angle of your display, and often provide a low quality image. + +* Use an external webcam. 1080p preferred or 720p at a minimum. Typically, either will be better quality than the built-in camera on your laptop. +* Lighting - Adjusting your lighting may help you get a better camera feed in less than optimal lighting conditions. + * Optimize the ambient lighting within your space first. + * There should be no window or strong light source behind you that darkens your face + * There should be no strong light source from one side that casts a shadow on the opposite side of your face. + * Good ambient lighting from your ceiling lights or windows may be enough as long as they are in front of you. + * Diffused lighting is better than harsh, direct lighting. +* Background – keep it clean and uncluttered. It’s great to show off your personality/style in your home, just be sure to keep everything appropriate for a general audience and compliant with the Code of Conduct. A plain wall is also just fine, no need to overdo it. +* Camera Position - as close as possible at your eye level, not pointing up towards your nose or the ceiling, or down towards the floor. It can be as simple as raising your laptop via a few books. Or if you have an external webcam, position it on the top edge or close to the top of the screen from which you are advancing your slides/notes. +* Keep eye contact with the camera just like you would look at your audience during an in-person presentation. It's okay to look away for brief moments, just make sure you look towards the camera for the majority of the presentation. +* Video with more lighting tips [https://youtu.be/rGcAM1CNEU0](https://youtu.be/rGcAM1CNEU0) + +### Audio + +#### Microphone Types + +**Best:** External microphone (condenser recommended over dynamic*) via a USB connection or DAC. This type of microphone will pick up audio from a distance as well as up close really well. This means you can position it a fair distance away from yourself when recording. If using one of these microphones, try to position it out of frame from your video. + +**Good:** Headset Microphone, this could be a microphone located on the wires like on mobile earphones, the mic on your wireless earphones as well as the usual fold down microphone on a headset. All of these assist with isolating microphone pick-up from ambient noises within your recording/streaming space. Wired headsets will give you better quality audio than wireless. + +**Acceptable:** External microphone built into your webcam. Often better quality than your built-in laptop microphone. + +**Worst:** Your built-in laptop microphone. These are generally low-quality microphones, and they have little or no ability to filter out background noise. + +#### Sound Environment + +##### Background Noise +It’s best to be in a controlled environment with little to no background noise. +If this is not possible you can use your recording software and other software to remove background noise. +Another option to filtering out background noise or being in a controlled environment is using push to talk, or unmuting your mic whenever you need to speak. + +** Removing Background noise in Zoom** + +In zoom settings under ``Audio`` +Change the Suppress background noise setting to ``High`` + +** Removing Background noise with Krisp** + +Krisp provides AI powered background noise cancellation, see [krisp.ai](https://krisp.ai/) for more information. + +** Removing Background noise with NVIDIA Broadcast or RTX Voice** + +If you're using Windows, and are using certain models of NVIDIA GPU, you can install either NVIDIA Broadcast or RTX Voice to filter out background noise. See [RTX Voice setup guide](https://www.nvidia.com/en-us/geforce/guides/nvidia-rtx-voice-setup-guide/) and [Broadcast app setup guide](https://www.nvidia.com/en-gb/geforce/guides/broadcast-app-setup-guide/) for more information. + +##### Other Tips +* Mute all notifications and programs not being recorded +* Disable any unnecessary audio devices + +### Screensharing + +* Increase the font size when sharing terminals, text editors +* Ensure you have all the windows you need opened before recording. +* Export any sensitive variables needed in your terminals before starting your presentation +* If using a passworded ssh key, Start a ssh-agent in the terminal beforehand. + +### Hardware + +Here are some equipment recommendations from the CNCF: + +#### Headset Microphones + +Logitech / Plantronics – i.e. Logitech H111 / Logitech H390 / Plantronics C225 + +#### External Microphones + +Blue / Samson – i.e. Blue Snowball / Blue Yeti / Samson Meteor / Samson G-Track + +#### Webcams + +Good value – Logitech C270 + +Value + added features – Logitech B525/C615 + +Higher resolution, better microphone – Logitech 9series / Microsoft LifeCam + +More info – https://www.tomsguide.com/news/where-to-buy-webcams-now-these-retailers-have-stock + +#### Presentation remotes + +Logitech / Canon / Kensington / SMK + +Tested and recommended for PC or Mac – Logitech R400, R800, Spotlight / Canon PR500, PR100 diff --git a/mentoring/programs/contributor-workshop/resources/how-we-communicate.md b/mentoring/programs/contributor-workshop/resources/how-we-communicate.md deleted file mode 100644 index 777929e2..00000000 --- a/mentoring/programs/contributor-workshop/resources/how-we-communicate.md +++ /dev/null @@ -1,33 +0,0 @@ -## How We Communicate - -### Duration - -10-30 minutes - -### Task Overview - -Show how we communicate in the community, and which tools are for what purpose. - -### Slides - -Refer to previous workshops for inspirations. - -### Details To Cover - -- [Code of Conduct](https://git.k8s.io/community/code-of-conduct.md) (CoC) -- Where We Talk: - - Slack - - Discuss -- How We Decide: - - GitHub - - Zoom - - Mailing List -- Calendar -- Meetups - -### Ideas - -- Have a #ncw channel on Slack. The first person who finds the Slack channel with the most members, or the longest name(etc) and posts in here wins a prize! -- Everyone introduces their neighbor and a cool Kubernetes fact about them in a Slack or Discuss channel/topic. -- Put an easter egg in the mailing list and whoever discovers it first by joining and reading the discussions, wins a prize! -- Come up with the most creative TL;DR for the CoC. \ No newline at end of file diff --git a/mentoring/programs/contributor-workshop/resources/labels-and-bots.md b/mentoring/programs/contributor-workshop/resources/labels-and-bots.md deleted file mode 100644 index 0e191f03..00000000 --- a/mentoring/programs/contributor-workshop/resources/labels-and-bots.md +++ /dev/null @@ -1,25 +0,0 @@ -## Labels and Bots - -### Duration - -10 - 15 minutes - -### Task Overview - -Show the Kubernetes automation and PR workflow, as well as the bot command help page. -This task is meant as a short overview for Intermediate content. - -### Slides - -The [PR workflow diagram](https://git.k8s.io/community/blob/master/contributors/guide/git_workflow.png) is useful here. There are also previous slides that explain the differnet labels. - -### Details To Cover - -- Which labels are used how, and by whom? -- How to add labels -- Other bot commands -- Prow - -### Ideas - -- Play with bots in the [contributor playground](https://sigs.k8s.io/contributor-playground) diff --git a/mentoring/programs/contributor-workshop/resources/live-pr-demo.md b/mentoring/programs/contributor-workshop/resources/live-pr-demo.md deleted file mode 100644 index 27b6c97e..00000000 --- a/mentoring/programs/contributor-workshop/resources/live-pr-demo.md +++ /dev/null @@ -1,24 +0,0 @@ -## Live PR Demo - -### Duration - -Plan for about 30 minutes - -### Task Overview - -Demonstrate opening a pull request against the [Kubernetes/Kubernetes](https://git.k8s.io/kubernetes) (k/k) repository. There are some docs cleanup good-first-issues, but feel free to show off something you've been working on for a while. - -### Slides - -None; this is a live demo. - -### Details To Cover - -- Make sure to prepare code in advance but only commit locally -- Show the k/k pull request workflow -- Show the PR templates and fill them out, explaining why -- Interact with the bot and briefly mention labels/OWNERS files -- Leave room for questions, but be aware that the workflow will be covered in depth later. - -### Ideas -- ask the audience or a pre-planned reviewer for code review, showing more of the k/k automation diff --git a/mentoring/programs/contributor-workshop/resources/live-workshop/README.md b/mentoring/programs/contributor-workshop/resources/live-workshop/README.md new file mode 100644 index 00000000..3958d322 --- /dev/null +++ b/mentoring/programs/contributor-workshop/resources/live-workshop/README.md @@ -0,0 +1,39 @@ +# Live Workshops Resources + +## Overview + +This folder contains the [handbook for the New Contributor Workshop Content Lead](./new-contributor-workshop-lead.md) as well as playbooks for each of the Contributor Workshop sessions in a live setting. + +This workshop is held periodically by the Kubernetes Community, but materials and processes may be used at contributor focused summits and events anywhere. + +Slides from previous New Contributor Workshops can be found [here](https://github.com/cncf/presentations/blob/master/kubernetes/README.md#kubernetes-new-contributor-workshops). + +## Sample Track for Beginner Workshop + +This workshop is meant for folks who have never contributed to opensource before and/or need help setting up a Kubernetes developer environment. + +1. Welcome +1. [Live PR Demo](./live-pr-demo.md) +1. [Paths to Contributorship](./contributor-paths.md) +1. [Communication in the Kubernetes Community](./how-we-communicate.md) +1. [Community Group and Governance Overview](./community-groups.md) +1. [Kubernetes Orgs Overview](./repo-tour.md) +1. [Workspace Setup](./workspace-setup.md) +1. [Local Build&Test](./build-and-test.md) +1. [Pull Request Exercise](./playground-exercise.md) +1. [Find Your First Issue](./first-issue-help.md) + +## Sample Track for Intermediate Workshop + +This workshop differs from the Beginner workshop in that participants are expected to have a working Docker/Kubernetes/Go setup. They have a basic understanding of how opensource contributions work, and may have opened a PR against Kubernetes before. + +1. Welcome +1. [Live PR Demo](./live-pr-demo.md) +1. [Paths to Contributorship](./contributor-paths.md) +1. [Communication in the Kubernetes Community](./how-we-communicate.md) +1. [Community Group and Governance Overview](./community-groups.md) +1. [Kubernetes Orgs Overview](./repo-tour.md) +1. k/k Walkthrough +1. [Local Build&Test](./build-and-test.md) +1. [Labels, Bots and Git Workflow](./labels-and-bots.md) +1. [Find Your First Issue](./first-issue-help.md) diff --git a/mentoring/programs/contributor-workshop/resources/live-workshop/build-and-test.md b/mentoring/programs/contributor-workshop/resources/live-workshop/build-and-test.md new file mode 100644 index 00000000..147d91a3 --- /dev/null +++ b/mentoring/programs/contributor-workshop/resources/live-workshop/build-and-test.md @@ -0,0 +1,27 @@ +## Build and Test + +### Duration + +40-60 minutes, depending on beginner vs intermediate participants + +### Task Overview + +Build Kubernetes binaries locally, and do some fun things with them. + +**Important** Have facilitators to help with technical issues (2-3 is enough for Intermediate, you want 5 for Beginner) + +### Slides + +Clear command line instructions. + +### Details To Cover + +- This is the hands-on part. Details are up to you; look to previous workshops for inspiration. +- Adjust difficulty based on whether this is the Beginner or Intermediate workshop. +- It is _extremely important_ to run this part of the workshop several times previously, and to make sure that versions match those in the [workspace setup](./workspace-setup.md). + +### Ideas + +- Do a fun thing with the Kubernetes [go client](https://git.k8s.io/client-go) and a [kind](https://sigs.k8s.io/kind) cluster. +- Build and modify `kubectl`. +- Try a `make` command; be aware you may need to give docker a lot of space on your machine for a successful build. diff --git a/mentoring/programs/contributor-workshop/resources/live-workshop/community-groups.md b/mentoring/programs/contributor-workshop/resources/live-workshop/community-groups.md new file mode 100644 index 00000000..01a8c80c --- /dev/null +++ b/mentoring/programs/contributor-workshop/resources/live-workshop/community-groups.md @@ -0,0 +1,27 @@ +## Community Groups + +### Duration + +15 minutes + +### Task Overview + +Introduce SIGs, Working Groups, and a tiny bit of governance (if you must). + +### Slides + +Refer to previous workshops for inspirations. + +### Details To Cover + +- SIGs +- Subprojects +- Working Groups +- User Groups +- Committees +- How to Join Any Of The Above + +### Ideas + +- Stay simple. Don't make it too complicated. +- Ask participants to define a few example SIGs via audience interaction. \ No newline at end of file diff --git a/mentoring/programs/contributor-workshop/resources/live-workshop/contributor-paths.md b/mentoring/programs/contributor-workshop/resources/live-workshop/contributor-paths.md new file mode 100644 index 00000000..d14691eb --- /dev/null +++ b/mentoring/programs/contributor-workshop/resources/live-workshop/contributor-paths.md @@ -0,0 +1,26 @@ +## Contributor Paths + +### Duration + +10-30 minutes + +### Task Overview + +This is about contributor origin stories. + +### Slides + +Refer to previous workshops for inspirations + +### Details To Cover + +- Who can contribute? +- What skills are needed? +- How to Fit Contributions Into Your Job +- Balance knowledge with learning and the needs of the project + +### Ideas + +- Share some contributor origin stories +- Ask the room why they are at the workshop +- Have a few people share their thoughts diff --git a/mentoring/programs/contributor-workshop/resources/live-workshop/first-issue-help.md b/mentoring/programs/contributor-workshop/resources/live-workshop/first-issue-help.md new file mode 100644 index 00000000..b99488af --- /dev/null +++ b/mentoring/programs/contributor-workshop/resources/live-workshop/first-issue-help.md @@ -0,0 +1,31 @@ +## Finding Your First Issue + +### Duration + +20 minutes + +### Task Overview + +Set participants on as much of a paved path to contributor success as possible. +At this point in the workshop, participants should know what kind of issue they want to tackle. + +### Slides + +Refer to previous workshops for inspirations + +### Details To Cover + +- help-wanted and good-first-issue labels +- Up and coming sandbox projects +- Working with your SIG +- Refer participants to specific SIGs +- How to "claim" an issue (since non-members cannot self-assign) +- Path to [membership](/community-membership.md) + +### Ideas + +- Give folks time to discuss and help each other +- Gather information from SIGs in advance (via Slack, Twitter...) on who needs help, and at what level +- Prepare a list of issues and assign folks right there +- Connect participants to mentoring tracks if available (e.g. Release Team Shadow) + diff --git a/mentoring/programs/contributor-workshop/resources/live-workshop/how-we-communicate.md b/mentoring/programs/contributor-workshop/resources/live-workshop/how-we-communicate.md new file mode 100644 index 00000000..777929e2 --- /dev/null +++ b/mentoring/programs/contributor-workshop/resources/live-workshop/how-we-communicate.md @@ -0,0 +1,33 @@ +## How We Communicate + +### Duration + +10-30 minutes + +### Task Overview + +Show how we communicate in the community, and which tools are for what purpose. + +### Slides + +Refer to previous workshops for inspirations. + +### Details To Cover + +- [Code of Conduct](https://git.k8s.io/community/code-of-conduct.md) (CoC) +- Where We Talk: + - Slack + - Discuss +- How We Decide: + - GitHub + - Zoom + - Mailing List +- Calendar +- Meetups + +### Ideas + +- Have a #ncw channel on Slack. The first person who finds the Slack channel with the most members, or the longest name(etc) and posts in here wins a prize! +- Everyone introduces their neighbor and a cool Kubernetes fact about them in a Slack or Discuss channel/topic. +- Put an easter egg in the mailing list and whoever discovers it first by joining and reading the discussions, wins a prize! +- Come up with the most creative TL;DR for the CoC. \ No newline at end of file diff --git a/mentoring/programs/contributor-workshop/resources/live-workshop/labels-and-bots.md b/mentoring/programs/contributor-workshop/resources/live-workshop/labels-and-bots.md new file mode 100644 index 00000000..0e191f03 --- /dev/null +++ b/mentoring/programs/contributor-workshop/resources/live-workshop/labels-and-bots.md @@ -0,0 +1,25 @@ +## Labels and Bots + +### Duration + +10 - 15 minutes + +### Task Overview + +Show the Kubernetes automation and PR workflow, as well as the bot command help page. +This task is meant as a short overview for Intermediate content. + +### Slides + +The [PR workflow diagram](https://git.k8s.io/community/blob/master/contributors/guide/git_workflow.png) is useful here. There are also previous slides that explain the differnet labels. + +### Details To Cover + +- Which labels are used how, and by whom? +- How to add labels +- Other bot commands +- Prow + +### Ideas + +- Play with bots in the [contributor playground](https://sigs.k8s.io/contributor-playground) diff --git a/mentoring/programs/contributor-workshop/resources/live-workshop/live-pr-demo.md b/mentoring/programs/contributor-workshop/resources/live-workshop/live-pr-demo.md new file mode 100644 index 00000000..27b6c97e --- /dev/null +++ b/mentoring/programs/contributor-workshop/resources/live-workshop/live-pr-demo.md @@ -0,0 +1,24 @@ +## Live PR Demo + +### Duration + +Plan for about 30 minutes + +### Task Overview + +Demonstrate opening a pull request against the [Kubernetes/Kubernetes](https://git.k8s.io/kubernetes) (k/k) repository. There are some docs cleanup good-first-issues, but feel free to show off something you've been working on for a while. + +### Slides + +None; this is a live demo. + +### Details To Cover + +- Make sure to prepare code in advance but only commit locally +- Show the k/k pull request workflow +- Show the PR templates and fill them out, explaining why +- Interact with the bot and briefly mention labels/OWNERS files +- Leave room for questions, but be aware that the workflow will be covered in depth later. + +### Ideas +- ask the audience or a pre-planned reviewer for code review, showing more of the k/k automation diff --git a/mentoring/programs/contributor-workshop/resources/live-workshop/new-contributor-workshop-lead.md b/mentoring/programs/contributor-workshop/resources/live-workshop/new-contributor-workshop-lead.md new file mode 100644 index 00000000..b6398d28 --- /dev/null +++ b/mentoring/programs/contributor-workshop/resources/live-workshop/new-contributor-workshop-lead.md @@ -0,0 +1,54 @@ +# New Contributor Workshop Lead + +## Overview +The New Contributor Workshop Lead is in charge of planning and executing the New Contributor Workshop. They will coordinate with the overall Events Team and the organizers of related activities aimed at new contributors. + +## Skills and Qualifications + +The New Contributor Content Lead must be a current, active Kubernetes contributor who is knowledgeable of the community and organizational structure of the Kubernetes project, as well as familiar with building and developing Kubernetes. +They should have experience and be comfortable with teaching in a workshop setting and presenting interactively in front of an audience. +Additionally, they must be able to relate to and empathize with newcomers of many different experience levels. +As this role is part of a subproject of SIG-contributor-experience, the New Contributor Content Lead must be a member of SIG-contributor-experience. + +## Activities + +*These tasks reflect a rough timeline leading from the end of the previous New Contributor Workshop to the currently planned one.* +- Attend event planning meetings in preparation for the New Contributor Workshop, where applicable. +- Create a Workshop Content Proposal and link in an Issue to k/community: + - determine sessions and their overall topic (e.g. How We Communicate, Code Base Walkthrough, etc) + - determine what difficulty/experience levels will be offered, if any, and coordinate with Lead + - determine workshop capacity, and coordinate with Lead + - determine room requirements (size, number, table/chair layout, A/V) and coordinate with the planning team +- Coordinate with New Contributor Content Shadows to prepare them for leading this role. +- Recruit and coordinate with workshop teachers for any sessions/topics you do not wish to teach yourself (e.g. invite someone to speak on "Communication in the Kubernetes Project"). +- Make modifications and continuous improvements to the new contributor workshop template. +Incorporate feedback from previous New Contributor Workshops. +Shadows and co-presenters are expected to assist and review these updates. +[Past presentations are linked here](https://github.com/cncf/presentations/tree/master/kubernetes) - please make a copy of the existing deck before updating/editing. +- Work with Registration to: + - disseminate course materials (slides) in advance + - ensure participants sign the CLA + - ensure attendees meet technical and experience requirements for their course + - obtain a comprehensive list of names, emails, and GitHub handles +- Ensure to advertise the SIG-Intros. +- Solicit feedback from workshop participants. + +## Time Commitment + +1-2 hours/week most of the time, 4-5 in the weeks leading up to NCW, depending on previous teaching/shadowing experience. + +## Coupon Codes + +If you would like to share coupon codes for the CNCF store with your +attendees, please create an issue in the [kubernetes/funding] repo and +assign [SIG Contributor Experience chairs] for approval. + +The funding request should contain the following details: +- Number of coupon codes required +- Desired amount of each coupon code (e.g. $20) OR desired swags for each coupon code (e.g. 1 Tshirt, 2 stickers) + +Once the request is approved, the chairs will create a CNCF Service Desk +ticket to get the list of coupon codes. + +[kubernetes/funding]: https://github.com/kubernetes/funding +[SIG Contributor Experience chairs]: /sig-contributor-experience#chairs diff --git a/mentoring/programs/contributor-workshop/resources/live-workshop/playground-exercise.md b/mentoring/programs/contributor-workshop/resources/live-workshop/playground-exercise.md new file mode 100644 index 00000000..6aca9178 --- /dev/null +++ b/mentoring/programs/contributor-workshop/resources/live-workshop/playground-exercise.md @@ -0,0 +1,28 @@ +## Playground Exercise + +### Duration + +30 - 50 minutes + +### Task Overview + +Give new contributors the experience of the Kubernetes GitHub workflow! +This task requires some setup and planning. + +Create a New Contributor Workshop folder specific to this event, with teachers' and participants' GitHub handles in the OWNERS file. +[Here is an example](https://sigs.k8s.io/contributor-playground/seattle). Make sure to obtain participants' GitHub handles from the event registrar in advance. +Issue and PR exercise ideas can be found [here](https://sigs.k8s.io/contributor-playground/exercises). + +### Slides + +Refer to previous workshops for inspirations. + +### Details To Cover + +- Labels and bot commands - more material [here](./labels-and-bots.md) +- Automation +- How to assign reviewers + +### Ideas + +- The first person to `/honk` on a PR wins a prize! diff --git a/mentoring/programs/contributor-workshop/resources/live-workshop/repo-tour.md b/mentoring/programs/contributor-workshop/resources/live-workshop/repo-tour.md new file mode 100644 index 00000000..d1f46ee0 --- /dev/null +++ b/mentoring/programs/contributor-workshop/resources/live-workshop/repo-tour.md @@ -0,0 +1,24 @@ +## Repo Tour + +### Duration + +10 - 15 minutes + +### Task Overview + +Show that Kubernetes is not just about the Core Repository, but also about the other repos in the org and in kubernetes-sigs. + +### Slides + +Have a few overview slides, but also go off-book and live show the repos on GitHub. + +### Details To Cover + +- k/website, k/test-infra, k/community, k/enhancements, with explanations +- Exciting things in kubernetes-sigs + + +### Ideas + +- Ask participants if they have found or are interested in specific repos, and share about their purpose. +- Mention which repos need help, or have awesome good-first-issue shepherding from maintainers! \ No newline at end of file diff --git a/mentoring/programs/contributor-workshop/resources/live-workshop/workspace-setup.md b/mentoring/programs/contributor-workshop/resources/live-workshop/workspace-setup.md new file mode 100644 index 00000000..19dbef29 --- /dev/null +++ b/mentoring/programs/contributor-workshop/resources/live-workshop/workspace-setup.md @@ -0,0 +1,24 @@ +## Workspace Setup + +### Duration + +Plan for 90- 120 minutes of download and setup time when on wifi. When on a workshop specific network, this may be much shortened. + +### Task Overview + +Make sure all Beginning Contributors have a workspace setup for hacking on Kubernetes. + +**Important** Have facilitators to help with technical issues (3-5 for ~30 people) + +### Slides + +Clear and large download commands to copy into the terminal. + +### Details To Cover + +- Make sure everyone has the correct setup for a local build and test demo. + +### Ideas + +- Have a dedicated workshop network. +- When internet is slow, start the download and prep process during earlier sessions, to make sure everyone is up to date. diff --git a/mentoring/programs/contributor-workshop/resources/new-contributor-workshop-lead.md b/mentoring/programs/contributor-workshop/resources/new-contributor-workshop-lead.md deleted file mode 100644 index b6398d28..00000000 --- a/mentoring/programs/contributor-workshop/resources/new-contributor-workshop-lead.md +++ /dev/null @@ -1,54 +0,0 @@ -# New Contributor Workshop Lead - -## Overview -The New Contributor Workshop Lead is in charge of planning and executing the New Contributor Workshop. They will coordinate with the overall Events Team and the organizers of related activities aimed at new contributors. - -## Skills and Qualifications - -The New Contributor Content Lead must be a current, active Kubernetes contributor who is knowledgeable of the community and organizational structure of the Kubernetes project, as well as familiar with building and developing Kubernetes. -They should have experience and be comfortable with teaching in a workshop setting and presenting interactively in front of an audience. -Additionally, they must be able to relate to and empathize with newcomers of many different experience levels. -As this role is part of a subproject of SIG-contributor-experience, the New Contributor Content Lead must be a member of SIG-contributor-experience. - -## Activities - -*These tasks reflect a rough timeline leading from the end of the previous New Contributor Workshop to the currently planned one.* -- Attend event planning meetings in preparation for the New Contributor Workshop, where applicable. -- Create a Workshop Content Proposal and link in an Issue to k/community: - - determine sessions and their overall topic (e.g. How We Communicate, Code Base Walkthrough, etc) - - determine what difficulty/experience levels will be offered, if any, and coordinate with Lead - - determine workshop capacity, and coordinate with Lead - - determine room requirements (size, number, table/chair layout, A/V) and coordinate with the planning team -- Coordinate with New Contributor Content Shadows to prepare them for leading this role. -- Recruit and coordinate with workshop teachers for any sessions/topics you do not wish to teach yourself (e.g. invite someone to speak on "Communication in the Kubernetes Project"). -- Make modifications and continuous improvements to the new contributor workshop template. -Incorporate feedback from previous New Contributor Workshops. -Shadows and co-presenters are expected to assist and review these updates. -[Past presentations are linked here](https://github.com/cncf/presentations/tree/master/kubernetes) - please make a copy of the existing deck before updating/editing. -- Work with Registration to: - - disseminate course materials (slides) in advance - - ensure participants sign the CLA - - ensure attendees meet technical and experience requirements for their course - - obtain a comprehensive list of names, emails, and GitHub handles -- Ensure to advertise the SIG-Intros. -- Solicit feedback from workshop participants. - -## Time Commitment - -1-2 hours/week most of the time, 4-5 in the weeks leading up to NCW, depending on previous teaching/shadowing experience. - -## Coupon Codes - -If you would like to share coupon codes for the CNCF store with your -attendees, please create an issue in the [kubernetes/funding] repo and -assign [SIG Contributor Experience chairs] for approval. - -The funding request should contain the following details: -- Number of coupon codes required -- Desired amount of each coupon code (e.g. $20) OR desired swags for each coupon code (e.g. 1 Tshirt, 2 stickers) - -Once the request is approved, the chairs will create a CNCF Service Desk -ticket to get the list of coupon codes. - -[kubernetes/funding]: https://github.com/kubernetes/funding -[SIG Contributor Experience chairs]: /sig-contributor-experience#chairs diff --git a/mentoring/programs/contributor-workshop/resources/playground-exercise.md b/mentoring/programs/contributor-workshop/resources/playground-exercise.md deleted file mode 100644 index 6aca9178..00000000 --- a/mentoring/programs/contributor-workshop/resources/playground-exercise.md +++ /dev/null @@ -1,28 +0,0 @@ -## Playground Exercise - -### Duration - -30 - 50 minutes - -### Task Overview - -Give new contributors the experience of the Kubernetes GitHub workflow! -This task requires some setup and planning. - -Create a New Contributor Workshop folder specific to this event, with teachers' and participants' GitHub handles in the OWNERS file. -[Here is an example](https://sigs.k8s.io/contributor-playground/seattle). Make sure to obtain participants' GitHub handles from the event registrar in advance. -Issue and PR exercise ideas can be found [here](https://sigs.k8s.io/contributor-playground/exercises). - -### Slides - -Refer to previous workshops for inspirations. - -### Details To Cover - -- Labels and bot commands - more material [here](./labels-and-bots.md) -- Automation -- How to assign reviewers - -### Ideas - -- The first person to `/honk` on a PR wins a prize! diff --git a/mentoring/programs/contributor-workshop/resources/repo-tour.md b/mentoring/programs/contributor-workshop/resources/repo-tour.md deleted file mode 100644 index d1f46ee0..00000000 --- a/mentoring/programs/contributor-workshop/resources/repo-tour.md +++ /dev/null @@ -1,24 +0,0 @@ -## Repo Tour - -### Duration - -10 - 15 minutes - -### Task Overview - -Show that Kubernetes is not just about the Core Repository, but also about the other repos in the org and in kubernetes-sigs. - -### Slides - -Have a few overview slides, but also go off-book and live show the repos on GitHub. - -### Details To Cover - -- k/website, k/test-infra, k/community, k/enhancements, with explanations -- Exciting things in kubernetes-sigs - - -### Ideas - -- Ask participants if they have found or are interested in specific repos, and share about their purpose. -- Mention which repos need help, or have awesome good-first-issue shepherding from maintainers! \ No newline at end of file diff --git a/mentoring/programs/contributor-workshop/resources/templates/segment-template.md b/mentoring/programs/contributor-workshop/resources/templates/segment-template.md new file mode 100644 index 00000000..e7d9edd0 --- /dev/null +++ b/mentoring/programs/contributor-workshop/resources/templates/segment-template.md @@ -0,0 +1,33 @@ +--- +title: "Segment Name" # The name of the page +weight: 0 # Ordering of the page +description: | + A brief description of what this segment aims to cover. +--- + +## Goals + + +By the end of this segment you should be able to: +* Identify areas of Kubernetes you would like to contribute to +* Understand the differences between Special Interest Groups, Working Groups and Subprojects + +## Subsection Heading + + + +## Another Subsection Heading + + + +## Exercise : Name Of Exercise + + + +### Name Of First Step + + + +### Name Of Second Step + + diff --git a/mentoring/programs/contributor-workshop/resources/workspace-setup.md b/mentoring/programs/contributor-workshop/resources/workspace-setup.md deleted file mode 100644 index 19dbef29..00000000 --- a/mentoring/programs/contributor-workshop/resources/workspace-setup.md +++ /dev/null @@ -1,24 +0,0 @@ -## Workspace Setup - -### Duration - -Plan for 90- 120 minutes of download and setup time when on wifi. When on a workshop specific network, this may be much shortened. - -### Task Overview - -Make sure all Beginning Contributors have a workspace setup for hacking on Kubernetes. - -**Important** Have facilitators to help with technical issues (3-5 for ~30 people) - -### Slides - -Clear and large download commands to copy into the terminal. - -### Details To Cover - -- Make sure everyone has the correct setup for a local build and test demo. - -### Ideas - -- Have a dedicated workshop network. -- When internet is slow, start the download and prep process during earlier sessions, to make sure everyone is up to date. diff --git a/mentoring/programs/contributor-workshop/videoguide.md b/mentoring/programs/contributor-workshop/videoguide.md deleted file mode 100644 index 2e96183f..00000000 --- a/mentoring/programs/contributor-workshop/videoguide.md +++ /dev/null @@ -1,131 +0,0 @@ -# Video Recording Guide for NCW2 DRAFT - - -## Introduction - - -## Setting up Your Video Environment - - -### Video - -The primary video in your NCW presentation will be screen-sharing, but it's also great if you can have some webcam segments. New contributors want to see the faces of current contributors. - - -#### Webcam Recording - -Use an external webcam. 1080p preferred or 720p at a minimum. Typically, either will be better quality than the built-in camera on your laptop. They often have an autofocus function and auto - -lighting adjustments that help you get a better camera feed in less than optimal lighting conditions. - -It’s best to optimize the ambient lighting within your space first. There should be no window or strong light source behind you that darkens your face and no strong light source from one side that casts a shadow on the opposite side of your face. Good ambient lighting from your ceiling lights or windows may be enough as long as they are in front of you. Diffused lighting is better than harsh, direct lighting. - - - - - -Webcam tips: - - - -* Background – keep it clean and uncluttered. It’s great to show off your personality/style in your home, just be sure to keep everything appropriate for a general audience and compliant with the Code of Conduct. A plain wall is also just fine, no need to overdo it. -* Position the camera as close as possible at your eye level, not pointing up towards your nose or the ceiling, or down towards the floor. It can be as simple as raising your laptop via a few books. Or if you have an external webcam, position it on the top edge or close to the top of the screen from which you are advancing your slides/notes. -* Keep eye contact with the camera just like you would look at your audience during an in-person presentation. -* Check [https://drive.google.com/drive/u/1/folders/1cvGcRgX9IWNR_csNVJ0nWRYD65Wmx9hu](https://drive.google.com/drive/u/1/folders/1cvGcRgX9IWNR_csNVJ0nWRYD65Wmx9hu) for virtual background images if you’d like to use them. - -Please, check the 4 minute video: [https://youtu.be/rGcAM1CNEU0](https://youtu.be/rGcAM1CNEU0) for more tips and examples. - - -#### Resolution - -Videos should ideally be recorded at 1080p or 720p if you’re using a video device, or at one of the following resolutions for screencasts: - - - -* 1440x1080 -* 1440x900 -* 1280x960 -* 1368x768 -* 1280x800 -* 1280x720 -* 1024x768 - -Particularly, do not record the video on the highest resolution your computer offers, such as 3200x1800. Such large screen sizes will make it difficult for folks with low bandwidth or older computers to view your broadcast. If you have a high-resolution screen on your computer, this may mean downgrading the resolution for screencasting. - - -### Audio - -Good audio is important. All recorded NCW segments have audio and this is the most important element that reinforces your presentation slides. In addition to software, you'll need hardware for recording audio. We realize that you don't necessarily have a chance to purchase or borrow the best audio equipment for an NCW video, but here's a few recommendations: - -**Best:** External microphone (condenser recommended over dynamic*) usually via a USB connection (e.g. Blue / Rhode / Razer brands). This type of microphone allows you to keep your mouth somewhat distant from the microphone, not up very close. You should try to keep it out of the video shot. - -**Good:** A headset with microphone, even if it’s earbud type with the mic on the lanyard. It’s about isolating microphone pick-up from ambient noises within your recording/streaming space. Input via USB or single mini-jack is typical or it can be dual minijack for older laptops/PCs. Cordless headsets also work, but it's better to use radio frequency dongles (RF) than bluetooth, which tends to produce sound quality issues. - -**Acceptable:** External microphone built into your webcam. Often better quality than your built-in laptop microphone. - -**Worst:** Your built-in laptop microphone. These are generally low-quality microphones, and they have little or no ability to filter out background noise. - -In general, it’s best to be in a controlled environment with little to no background noise and mute all other audio devices that are not necessary. - - - - -### Console Sessions - -Please, don’t forget to increase the font size when sharing a console. - - -## Recording Options and Instructions - - -### Zoom - - - -* Start a meeting in zoom (you can start and record a meeting with a single participant) -* Get the presentation slide setup with the screenshare. -* Once thats all setup click the record button -* when you click end meeting the video should export locally if you're doing the local record option -* Rename and copy mp4 file to google drive folder: [https://drive.google.com/drive/u/1/folders/1cvGcRgX9IWNR_csNVJ0nWRYD65Wmx9hu](https://drive.google.com/drive/u/1/folders/1cvGcRgX9IWNR_csNVJ0nWRYD65Wmx9hu) - - - -### Documentation and Exercises - - -### Where to Upload - -[https://drive.google.com/drive/u/1/folders/1cvGcRgX9IWNR_csNVJ0nWRYD65Wmx9hu](https://drive.google.com/drive/u/1/folders/1cvGcRgX9IWNR_csNVJ0nWRYD65Wmx9hu) - please upload all video files here. - - -## Tips - - -## Equipment Recommendations - -Here are some equipment recommendations from the CNCF: - -Headset Microphones: - -Logitech / Plantronics – i.e. Logitech H111 / Logitech H390 / Plantronics C225 - -External Microphones: - -Blue / Samson – i.e. Blue Snowball / Blue Yeti / Samson Meteor / Samson G-Track - -Webcams: - -Good value – Logitech C270 - -Value + added features – Logitech B525/C615 - -Higher resolution, better microphone – Logitech 9series / Microsoft LifeCam - -More info – https://www.tomsguide.com/news/where-to-buy-webcams-now-these-retailers-have-stock - -Presentation remotes: - -Logitech / Canon / Kensington / SMK - -Tested and recommended for PC or Mac – Logitech R400, R800, Spotlight / Canon PR500, PR100 - -- cgit v1.2.3 From 0a813ab9727c7500c3049b4dc881d9d176493818 Mon Sep 17 00:00:00 2001 From: Alison Date: Wed, 9 Jun 2021 10:49:26 +0100 Subject: Update mentoring/programs/contributor-workshop/resources/guides/videoguide.md Signed-off-by: Alison Dowdney Co-authored-by: Bob Killen --- mentoring/programs/contributor-workshop/resources/guides/videoguide.md | 1 - 1 file changed, 1 deletion(-) (limited to 'mentoring/programs') diff --git a/mentoring/programs/contributor-workshop/resources/guides/videoguide.md b/mentoring/programs/contributor-workshop/resources/guides/videoguide.md index d9973c92..58926853 100644 --- a/mentoring/programs/contributor-workshop/resources/guides/videoguide.md +++ b/mentoring/programs/contributor-workshop/resources/guides/videoguide.md @@ -386,7 +386,6 @@ Good value – Logitech C270 Value + added features – Logitech B525/C615 -Higher resolution, better microphone – Logitech 9series / Microsoft LifeCam More info – https://www.tomsguide.com/news/where-to-buy-webcams-now-these-retailers-have-stock -- cgit v1.2.3 From 8a99e562deedb4c38200311b23a3085213709e3b Mon Sep 17 00:00:00 2001 From: Alison Date: Wed, 9 Jun 2021 10:49:39 +0100 Subject: Update mentoring/programs/contributor-workshop/resources/guides/videoguide.md Signed-off-by: Alison Dowdney Co-authored-by: Bob Killen --- mentoring/programs/contributor-workshop/resources/guides/videoguide.md | 1 - 1 file changed, 1 deletion(-) (limited to 'mentoring/programs') diff --git a/mentoring/programs/contributor-workshop/resources/guides/videoguide.md b/mentoring/programs/contributor-workshop/resources/guides/videoguide.md index 58926853..bf7381b9 100644 --- a/mentoring/programs/contributor-workshop/resources/guides/videoguide.md +++ b/mentoring/programs/contributor-workshop/resources/guides/videoguide.md @@ -384,7 +384,6 @@ Blue / Samson – i.e. Blue Snowball / Blue Yeti / Samson Meteor / Samson G-Trac Good value – Logitech C270 -Value + added features – Logitech B525/C615 More info – https://www.tomsguide.com/news/where-to-buy-webcams-now-these-retailers-have-stock -- cgit v1.2.3 From f49785a4090055086ef52d2f61d35fb5a7078bee Mon Sep 17 00:00:00 2001 From: Alison Date: Wed, 9 Jun 2021 10:49:47 +0100 Subject: Update mentoring/programs/contributor-workshop/resources/guides/videoguide.md Co-authored-by: Bob Killen --- mentoring/programs/contributor-workshop/resources/guides/videoguide.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'mentoring/programs') diff --git a/mentoring/programs/contributor-workshop/resources/guides/videoguide.md b/mentoring/programs/contributor-workshop/resources/guides/videoguide.md index bf7381b9..c90e5138 100644 --- a/mentoring/programs/contributor-workshop/resources/guides/videoguide.md +++ b/mentoring/programs/contributor-workshop/resources/guides/videoguide.md @@ -382,7 +382,7 @@ Blue / Samson – i.e. Blue Snowball / Blue Yeti / Samson Meteor / Samson G-Trac #### Webcams -Good value – Logitech C270 +Good value – Logitech C920 -- cgit v1.2.3 From 6507ccf551f99822532de49b64a7428bc2fb5131 Mon Sep 17 00:00:00 2001 From: Alison Date: Wed, 9 Jun 2021 10:50:16 +0100 Subject: Update mentoring/programs/contributor-workshop/resources/guides/videoguide.md Signed-off-by: Alison Dowdney Co-authored-by: Bob Killen --- mentoring/programs/contributor-workshop/resources/guides/videoguide.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'mentoring/programs') diff --git a/mentoring/programs/contributor-workshop/resources/guides/videoguide.md b/mentoring/programs/contributor-workshop/resources/guides/videoguide.md index c90e5138..53eb422e 100644 --- a/mentoring/programs/contributor-workshop/resources/guides/videoguide.md +++ b/mentoring/programs/contributor-workshop/resources/guides/videoguide.md @@ -202,7 +202,7 @@ For example ### Updating Youtube -Once you have uploaded the video to drive, upload it to youtube, and update the previous recording on youtube ( if any ) +Once you have uploaded the video to drive, contact one of the [youtube admins](/communication/moderators.md#youtube-channel) to upload it to the Kubernetes YouTube channel. #### Upload the new video -- cgit v1.2.3 From 8c45b72d6999f52866795a2e9b8492bfbd415ba9 Mon Sep 17 00:00:00 2001 From: Alison Dowdney Date: Wed, 9 Jun 2021 11:32:46 +0100 Subject: Update guides, break out YT admin doc --- .../resources/guides/obssettings.png | Bin 0 -> 75253 bytes .../resources/guides/videoguide.md | 276 +++++++-------------- .../resources/guides/videouploadguide.md | 97 ++++++++ 3 files changed, 187 insertions(+), 186 deletions(-) create mode 100644 mentoring/programs/contributor-workshop/resources/guides/obssettings.png create mode 100644 mentoring/programs/contributor-workshop/resources/guides/videouploadguide.md (limited to 'mentoring/programs') diff --git a/mentoring/programs/contributor-workshop/resources/guides/obssettings.png b/mentoring/programs/contributor-workshop/resources/guides/obssettings.png new file mode 100644 index 00000000..b8946ccd Binary files /dev/null and b/mentoring/programs/contributor-workshop/resources/guides/obssettings.png differ diff --git a/mentoring/programs/contributor-workshop/resources/guides/videoguide.md b/mentoring/programs/contributor-workshop/resources/guides/videoguide.md index 53eb422e..dc14051c 100644 --- a/mentoring/programs/contributor-workshop/resources/guides/videoguide.md +++ b/mentoring/programs/contributor-workshop/resources/guides/videoguide.md @@ -1,91 +1,82 @@ + # Video Recording Guide for Contributor Workshop Segments This guide covers, how to structure, record, upload and update video guides associated with workshop segments. -- [Video Recording Guide for Contributor Workshop Segments](#video-recording-guide-for-contributor-workshop-segments) - - [Format / Video Style](#format--video-style) - - [Encoding Guidelines](#encoding-guidelines) - - [Zoom Recording](#zoom-recording) - - [OBS](#obs) - - [Streamyard](#streamyard) - - [Adobe Media Encoder](#adobe-media-encoder) - - [Recording Guides](#recording-guides) +- [Format / Video Style](#format--video-style) +- [Encoding Guidelines](#encoding-guidelines) + - [Zoom Recording](#zoom-recording) + - [OBS](#obs) + - [Streamyard](#streamyard) + - [Adobe Media Encoder](#adobe-media-encoder) +- [Recording Guides](#recording-guides) + - [Record Using Zoom](#record-using-zoom) + - [Install Windowed extension (optional)](#install-windowed-extension-optional) + - [Start the meeting](#start-the-meeting) + - [Setting up slides for recording](#setting-up-slides-for-recording) + - [Without browser extension](#without-browser-extension) + - [With browser extension](#with-browser-extension) + - [Note : Exiting the windowed mode](#note--exiting-the-windowed-mode) + - [Adding your facecam](#adding-your-facecam) + - [Unmute your audio](#unmute-your-audio) - [Recording in Zoom](#recording-in-zoom) - - [Install Windowed extension (optional)](#install-windowed-extension-optional) - - [Start the meeting](#start-the-meeting) - - [Setting up slides for recording](#setting-up-slides-for-recording) - - [Without browser extension](#without-browser-extension) - - [With browser extension](#with-browser-extension) - - [Note : Exiting the windowed mode](#note--exiting-the-windowed-mode) - - [Adding your facecam](#adding-your-facecam) - - [Unmute your audio](#unmute-your-audio) - - [Recording in Zoom](#recording-in-zoom-1) - - [Note : Do a test recording first](#note--do-a-test-recording-first) - - [How to record](#how-to-record) - - [Recording in OBS](#recording-in-obs) - - [Recording in Streamyard](#recording-in-streamyard) - - [Updating / Adding video to a segment](#updating--adding-video-to-a-segment) - - [Rename your recording](#rename-your-recording) - - [Update Google Drive](#update-google-drive) - - [Uploading your video](#uploading-your-video) - - [What folder to upload to](#what-folder-to-upload-to) - - [Updating Youtube](#updating-youtube) - - [Upload the new video](#upload-the-new-video) - - [Adding the thumbnail image](#adding-the-thumbnail-image) - - [Setting the description](#setting-the-description) - - [Update the previous video for the segment if it exists](#update-the-previous-video-for-the-segment-if-it-exists) - - [Update the title](#update-the-title) - - [Update the thumbnail image](#update-the-thumbnail-image) - - [Update the Description](#update-the-description) - - [Update the Comments](#update-the-comments) - - [Updating the Segment page with video](#updating-the-segment-page-with-video) - - [Best Practices & Recommendations](#best-practices--recommendations) - - [Video](#video) - - [Camera Type](#camera-type) - - [Audio](#audio) - - [Microphone Types](#microphone-types) - - [Sound Environment](#sound-environment) - - [Background Noise](#background-noise) - - [Other Tips](#other-tips) - - [Screensharing](#screensharing) - - [Hardware](#hardware) - - [Headset Microphones](#headset-microphones) - - [External Microphones](#external-microphones) - - [Webcams](#webcams) - - [Presentation remotes](#presentation-remotes) + - [Note : Do a test recording first](#note--do-a-test-recording-first) + - [How to record](#how-to-record) + - [Recording in OBS](#recording-in-obs) + - [Recording in Streamyard](#recording-in-streamyard) +- [Updating / Adding video to a segment](#updating--adding-video-to-a-segment) + - [Rename your recording](#rename-your-recording) + - [Uploading your video to Google Drive](#uploading-your-video-to-google-drive) + - [Updating Youtube](#updating-youtube) +- [Update the Segment page with video](#update-the-segment-page-with-video) +- [Best Practices & Recommendations](#best-practices--recommendations) + - [Video](#video) + - [Camera Type](#camera-type) + - [Audio](#audio) + - [Microphone Types](#microphone-types) + - [Sound Environment](#sound-environment) + - [Background Noise](#background-noise) + - [Removing Background noise in Zoom](#removing-background-noise-in-zoom) + - [Removing Background noise with Krisp](#removing-background-noise-with-krisp) + - [Removing Background noise with NVIDIA Broadcast or RTX Voice](#removing-background-noise-with-nvidia-broadcast-or-rtx-voice) + - [Other Tips](#other-tips) + - [Screensharing](#screensharing) + - [Hardware](#hardware) + - [Headset Microphones](#headset-microphones) + - [External Microphones](#external-microphones) + - [Webcams](#webcams) + - [Presentation remotes](#presentation-remotes) ## Format / Video Style -You can use any format/style as long as the same information in the guide is captured in the video. Slides, A screenshare, greenscreen yourself into the repo even! Be creative. +You can use any format/style as long as the same information in the guide is captured in the video. Slides, A screenshare, green screen yourself into the repo even! Be creative. ## Encoding Guidelines ### Zoom Recording + Handled by zoom, Can't change these settings. ### OBS -(todo : match with media encoder) -type : standard -recording format : mp4 -encoder: x264 -rescale: 1920x1080 -rate control : VBR -bitrate : 16000kbps -CRF : ??? + +![OBS Settings](obssettings.png) ### Streamyard + Handled by Streamyard, Can't change these settings. ### Adobe Media Encoder + use Youtube 1080p Full HD ## Recording Guides Guides on how to record a presentation style video (slides/screen,facecam) -### Recording in Zoom +### Record Using Zoom #### Install Windowed extension (optional) + This makes it easier for you to share the slides to zoom. Allows you to pop out the fullscreen view to a single window. [GitHub Link](https://github.com/dralletje/Windowed) @@ -97,6 +88,7 @@ Start a meeting in zoom (you can start and record a meeting with a single partic #### Setting up slides for recording Open your slides in Presenter View + ![Presenter View](presenterview.png) It should open a presenter view, with a timer, slide notes, and change the tab from editor to a slideshow presentation @@ -173,28 +165,25 @@ Coming soon ### Rename your recording -Rename your recording to ``YYYY-MM-DD--.mp4`` +Rename your recording to ``YYYY-MM-DD--.mp4`` -Where -* ``YYYY-MM-DD`` being date, is the date video was recorded -* ```` being the name of the markdown file associated with that segment. see [CONTRIBUTING.md](https://github.com/kubernetes/contributor-site/tree/workshop/content/en/workshop/CONTRIBUTING.md#list-of-segments) -* ```` being the github handle of the person who recorded the video, if there are multiple presenters just add another dash and the handle. ``-`` +Where -For example +- ``YYYY-MM-DD`` being date, is the date video was recorded +- ```` being the name of the markdown file associated with that segment. see [CONTRIBUTING.md](https://github.com/kubernetes/contributor-site/tree/workshop/content/en/workshop/CONTRIBUTING.md#list-of-segments) +- ```` being the github handle of the person who recorded the video, if there are multiple presenters just add another dash and the handle. ``-`` -``2021-05-10-why-contribute-alisondy.mp4`` -``2021-05-10-why-contribute-alisondy-mrbobbytables.mp4`` +For example -### Update Google Drive +``2021-05-10-why-contribute-alisondy.mp4`` -#### Uploading your video +``2021-05-10-why-contribute-alisondy-mrbobbytables.mp4`` -You will upload your recording to the folder associated with your segment. More details in [What folder to upload to](#what-folder-to-upload-to) +### Uploading your video to Google Drive -##### What folder to upload to -There should be a folder for your segment. If one doesn't exist, create a new one with the segment name. +You will upload your recording to the folder associated with your segment. If the folder for your segment doesn't exist, create a new one with the segment name. -segment name being the name of the markdown file associated with that segment. see [CONTRIBUTING.md](https://github.com/kubernetes/contributor-site/tree/workshop/content/en/workshop/CONTRIBUTING.md#list-of-segments) +The segment name being the name of the markdown file associated with that segment. see [CONTRIBUTING.md](https://github.com/kubernetes/contributor-site/tree/workshop/content/en/workshop/CONTRIBUTING.md#list-of-segments) For example @@ -204,95 +193,9 @@ For example Once you have uploaded the video to drive, contact one of the [youtube admins](/communication/moderators.md#youtube-channel) to upload it to the Kubernetes YouTube channel. -#### Upload the new video - -In youtube, upload the same video and title it as follows - -```txt -Contributor Workshop : with | -``` - -For example - -```txt -Contributor Workshop : Why Contribute? with @alisondy | May 2021 -``` - -##### Adding the thumbnail image - -```markdown -TODO : Instructions on how to generate a thumbnail image, similar to https://gist.github.com/alisondy/e4ff3b483a32330ade0c880b4a4a10b1 -``` - -Set the thumbnail to the image generated in the previous step - -##### Setting the description - -Use the following template for setting the video description - -```txt -This is the video guide for the Contributor Workshop segment - -Link to this segments page: -https://kubernetes.dev/docs/workshop/ - -Link to the workshop: -https://kubernetes.dev/docs/workshop/ -``` +> Youtube Admins see [Video Upload Guide](videouploadguide.md) for details about uploading the segment to youtube -#### Update the previous video for the segment if it exists - -If you're updating an already existing video, follow the next steps to update the following on the previous video -- title -- thumbnail -- description -- comments section - -##### Update the title -Update the title on the previous video to match the following format - -```txt -Contributor Workshop : | | 🚨🚨 DEPRECATED 🚨🚨 -``` - -For example - -```txt -Contributor Workshop : Why Contribute? with @alisondy | May 2021 | 🚨🚨 DEPRECATED 🚨🚨 -``` - -##### Update the thumbnail image - -Update the Thumbnail image on the previous video to - -insert-deprecation-thumbnail-here.jpeg -```txt - - -THIS VIDEO IS DEPRECATED! -See the comments & description for details on where to find the new video guide! - - -``` - -##### Update the Description - -On the previous video, add the following to the start of the description -```txt -🚨🚨 DEPRECATED , Please see 🚨🚨 -``` - -##### Update the Comments - -On the previous video, add the following as a comment as Kubernetes YT & pin to the top of the comments - -```txt -🚨🚨 DEPRECATED , Please see 🚨🚨 -``` - -Close the comment section of the deprecated video - -#### Updating the Segment page with video +## Update the Segment page with video If adding to a segment page where video doesn't exist, Paste this at the top, after the frontmatter. Fill in the details with the youtube id of the video you just uploaded. @@ -309,21 +212,22 @@ If adding to a segment page where a video already exists, update the youtube id ### Video #### Camera Type -Use an external camera or webcam to capture your video. + +Use an external camera or webcam to capture your video. Built in webcams restrict the angle of you webcam, to the viewing angle of your display, and often provide a low quality image. -* Use an external webcam. 1080p preferred or 720p at a minimum. Typically, either will be better quality than the built-in camera on your laptop. -* Lighting - Adjusting your lighting may help you get a better camera feed in less than optimal lighting conditions. - * Optimize the ambient lighting within your space first. - * There should be no window or strong light source behind you that darkens your face - * There should be no strong light source from one side that casts a shadow on the opposite side of your face. - * Good ambient lighting from your ceiling lights or windows may be enough as long as they are in front of you. - * Diffused lighting is better than harsh, direct lighting. -* Background – keep it clean and uncluttered. It’s great to show off your personality/style in your home, just be sure to keep everything appropriate for a general audience and compliant with the Code of Conduct. A plain wall is also just fine, no need to overdo it. -* Camera Position - as close as possible at your eye level, not pointing up towards your nose or the ceiling, or down towards the floor. It can be as simple as raising your laptop via a few books. Or if you have an external webcam, position it on the top edge or close to the top of the screen from which you are advancing your slides/notes. -* Keep eye contact with the camera just like you would look at your audience during an in-person presentation. It's okay to look away for brief moments, just make sure you look towards the camera for the majority of the presentation. -* Video with more lighting tips [https://youtu.be/rGcAM1CNEU0](https://youtu.be/rGcAM1CNEU0) +- Use an external webcam. 1080p preferred or 720p at a minimum. Typically, either will be better quality than the built-in camera on your laptop. +- Lighting - Adjusting your lighting may help you get a better camera feed in less than optimal lighting conditions. + - Optimize the ambient lighting within your space first. + - There should be no window or strong light source behind you that darkens your face + - There should be no strong light source from one side that casts a shadow on the opposite side of your face. + - Good ambient lighting from your ceiling lights or windows may be enough as long as they are in front of you. + - Diffused lighting is better than harsh, direct lighting. +- Background – keep it clean and uncluttered. It’s great to show off your personality/style in your home, just be sure to keep everything appropriate for a general audience and compliant with the Code of Conduct. A plain wall is also just fine, no need to overdo it. +- Camera Position - as close as possible at your eye level, not pointing up towards your nose or the ceiling, or down towards the floor. It can be as simple as raising your laptop via a few books. Or if you have an external webcam, position it on the top edge or close to the top of the screen from which you are advancing your slides/notes. +- Keep eye contact with the camera just like you would look at your audience during an in-person presentation. It's okay to look away for brief moments, just make sure you look towards the camera for the majority of the presentation. +- Video with more lighting tips [https://youtu.be/rGcAM1CNEU0](https://youtu.be/rGcAM1CNEU0) ### Audio @@ -340,33 +244,35 @@ Built in webcams restrict the angle of you webcam, to the viewing angle of your #### Sound Environment ##### Background Noise + It’s best to be in a controlled environment with little to no background noise. If this is not possible you can use your recording software and other software to remove background noise. Another option to filtering out background noise or being in a controlled environment is using push to talk, or unmuting your mic whenever you need to speak. -** Removing Background noise in Zoom** +###### Removing Background noise in Zoom In zoom settings under ``Audio`` Change the Suppress background noise setting to ``High`` -** Removing Background noise with Krisp** +###### Removing Background noise with Krisp Krisp provides AI powered background noise cancellation, see [krisp.ai](https://krisp.ai/) for more information. -** Removing Background noise with NVIDIA Broadcast or RTX Voice** +###### Removing Background noise with NVIDIA Broadcast or RTX Voice If you're using Windows, and are using certain models of NVIDIA GPU, you can install either NVIDIA Broadcast or RTX Voice to filter out background noise. See [RTX Voice setup guide](https://www.nvidia.com/en-us/geforce/guides/nvidia-rtx-voice-setup-guide/) and [Broadcast app setup guide](https://www.nvidia.com/en-gb/geforce/guides/broadcast-app-setup-guide/) for more information. ##### Other Tips -* Mute all notifications and programs not being recorded -* Disable any unnecessary audio devices + +- Mute all notifications and programs not being recorded +- Disable any unnecessary audio devices ### Screensharing -* Increase the font size when sharing terminals, text editors -* Ensure you have all the windows you need opened before recording. -* Export any sensitive variables needed in your terminals before starting your presentation -* If using a passworded ssh key, Start a ssh-agent in the terminal beforehand. +- Increase the font size when sharing terminals, text editors +- Ensure you have all the windows you need opened before recording. +- Export any sensitive variables needed in your terminals before starting your presentation +- If using a passworded ssh key, Start a ssh-agent in the terminal beforehand. ### Hardware @@ -384,9 +290,7 @@ Blue / Samson – i.e. Blue Snowball / Blue Yeti / Samson Meteor / Samson G-Trac Good value – Logitech C920 - - -More info – https://www.tomsguide.com/news/where-to-buy-webcams-now-these-retailers-have-stock +More info – [https://www.tomsguide.com/news/where-to-buy-webcams-now-these-retailers-have-stock](https://www.tomsguide.com/news/where-to-buy-webcams-now-these-retailers-have-stock) #### Presentation remotes diff --git a/mentoring/programs/contributor-workshop/resources/guides/videouploadguide.md b/mentoring/programs/contributor-workshop/resources/guides/videouploadguide.md new file mode 100644 index 00000000..1e7c582e --- /dev/null +++ b/mentoring/programs/contributor-workshop/resources/guides/videouploadguide.md @@ -0,0 +1,97 @@ +# Segment Upload Guide for Youtube Admins + +## Upload the new video + +In youtube, upload the same video and title it as follows + +```txt +Contributor Workshop : with | +``` + +For example + +```txt +Contributor Workshop : Why Contribute? with @alisondy | May 2021 +``` + +## Adding the thumbnail image + +```markdown +TODO : Instructions on how to generate a thumbnail image, similar to https://gist.github.com/alisondy/e4ff3b483a32330ade0c880b4a4a10b1 +``` + +Set the thumbnail to the image generated in the previous step + +## Setting the description + +Use the following template for setting the video description + +```txt +This is the video guide for the Contributor Workshop segment + +Link to this segments page: +https://kubernetes.dev/docs/workshop/ + +Link to the workshop: +https://kubernetes.dev/docs/workshop/ +``` + +## Update the previous video for the segment if it exists + +If you're updating an already existing video, follow the next steps to update the following on the previous video + +- title +- thumbnail +- description +- comments section + +## Update the title + +Update the title on the previous video to match the following format + +```txt +Contributor Workshop : | | 🚨🚨 DEPRECATED 🚨🚨 +``` + +For example + +```txt +Contributor Workshop : Why Contribute? with @alisondy | May 2021 | 🚨🚨 DEPRECATED 🚨🚨 +``` + +## Update the thumbnail image + +Update the Thumbnail image on the previous video to + +insert-deprecation-thumbnail-here.jpeg + +```txt + + +THIS VIDEO IS DEPRECATED! +See the comments & description for details on where to find the new video guide! + + +``` + +## Update the Description + +On the previous video, add the following to the start of the description + +```txt +🚨🚨 DEPRECATED , Please see 🚨🚨 +``` + +## Update the Comments + +On the previous video, add the following as a comment as Kubernetes YT & pin to the top of the comments + +```txt +🚨🚨 DEPRECATED , Please see 🚨🚨 +``` + +Close the comment section of the deprecated video + +## Update the Playlist + +Update the youtube playlist with the segment recording. -- cgit v1.2.3 From ea804f0472b1cc5a400558365dee90808dbc54df Mon Sep 17 00:00:00 2001 From: Alison Dowdney Date: Wed, 23 Jun 2021 12:09:13 +0100 Subject: UIncorporate feedback --- mentoring/programs/contributor-workshop/README.md | 2 +- .../resources/guides/README.md | 24 ++++++++++++++-------- 2 files changed, 16 insertions(+), 10 deletions(-) (limited to 'mentoring/programs') diff --git a/mentoring/programs/contributor-workshop/README.md b/mentoring/programs/contributor-workshop/README.md index 535eee33..9199941d 100644 --- a/mentoring/programs/contributor-workshop/README.md +++ b/mentoring/programs/contributor-workshop/README.md @@ -12,7 +12,7 @@ The Contributor Workshop is currently in development, and has not been released You can view the live state of the site by going to [https://workshop--kubernetes-contributor.netlify.app/docs/workshop/](https://workshop--kubernetes-contributor.netlify.app/docs/workshop/) -The umbrella issue tracking getting this initiative available to the public is [#4830 in kubernetes/community](https://github.com/kubernetes/community/issues/4830). +The umbrella issue tracking getting this initiative available to the public is [kubernetes/community#4830](https://github.com/kubernetes/community/issues/4830). ## Getting Involved diff --git a/mentoring/programs/contributor-workshop/resources/guides/README.md b/mentoring/programs/contributor-workshop/resources/guides/README.md index d0db193d..7280f8ac 100644 --- a/mentoring/programs/contributor-workshop/resources/guides/README.md +++ b/mentoring/programs/contributor-workshop/resources/guides/README.md @@ -8,9 +8,11 @@ This folder contains guides and information on how to contribute to the Contribu The workshop is divided into segments. These segments exist as individual pages in the ``content/en/docs/workshop`` directory on the branch ``workshop`` in the ``contributor-site`` repo. -Each of these segments contain +Each of these segments contain: + * Written information * One or more Exercises + and may contain a video version of the written information. ## Guides @@ -25,11 +27,15 @@ How to structure, record, upload and update video guides associated with worksho ## Glossary of Terms -Segment - A page in the workshop directory covering a particular section of the Contributor Workshop. - This page may contain - * Written information - * Video version of the segment - * Hands on exercise -Exercise - Step by step, hands on activity within a segment. \ No newline at end of file +### Segment + +A page in the workshop directory covering a particular section of the Contributor Workshop. +This page may contain + +* Written information +* Video version of the segment +* Hands on exercise + +### Exercise + +A step by step, hands on activity within a segment. -- cgit v1.2.3 From 5e69ddef8a22370b4828cd0dfe5b1d7172bfa24c Mon Sep 17 00:00:00 2001 From: Alison Dowdney Date: Wed, 23 Jun 2021 12:19:02 +0100 Subject: Minor fixes --- mentoring/programs/contributor-workshop/README.md | 3 ++- .../contributor-workshop/resources/guides/videoguide.md | 12 +++--------- .../resources/templates/segment-template.md | 2 +- 3 files changed, 6 insertions(+), 11 deletions(-) (limited to 'mentoring/programs') diff --git a/mentoring/programs/contributor-workshop/README.md b/mentoring/programs/contributor-workshop/README.md index 9199941d..4b29b838 100644 --- a/mentoring/programs/contributor-workshop/README.md +++ b/mentoring/programs/contributor-workshop/README.md @@ -1,6 +1,6 @@ # Contributor Workshop -## Overview +## Overview The Contributor Workshop is a self paced course on the contributor site, aimed at both new and existing contributors. @@ -24,4 +24,5 @@ The umbrella issue tracking getting this initiative available to the public is [ * Join the discussion in #contributor-workshop-dev on Kubernetes Slack ## Previous Live Workshops + * [2019 NA Contributor Summit NCW](https://www.youtube.com/watch?v=uUJrGwAom-E&list=PL69nYSiGNLP0OWp38tPBc-jSlMmwWr6Ci&index=16) (Videos in playlist, links to first NCW video) diff --git a/mentoring/programs/contributor-workshop/resources/guides/videoguide.md b/mentoring/programs/contributor-workshop/resources/guides/videoguide.md index dc14051c..13094925 100644 --- a/mentoring/programs/contributor-workshop/resources/guides/videoguide.md +++ b/mentoring/programs/contributor-workshop/resources/guides/videoguide.md @@ -26,7 +26,7 @@ This guide covers, how to structure, record, upload and update video guides asso - [Recording in Streamyard](#recording-in-streamyard) - [Updating / Adding video to a segment](#updating--adding-video-to-a-segment) - [Rename your recording](#rename-your-recording) - - [Uploading your video to Google Drive](#uploading-your-video-to-google-drive) + - [Upload your video to Google Drive](#upload-your-video-to-google-drive) - [Updating Youtube](#updating-youtube) - [Update the Segment page with video](#update-the-segment-page-with-video) - [Best Practices & Recommendations](#best-practices--recommendations) @@ -179,15 +179,9 @@ For example ``2021-05-10-why-contribute-alisondy-mrbobbytables.mp4`` -### Uploading your video to Google Drive +### Upload your video to Google Drive -You will upload your recording to the folder associated with your segment. If the folder for your segment doesn't exist, create a new one with the segment name. - -The segment name being the name of the markdown file associated with that segment. see [CONTRIBUTING.md](https://github.com/kubernetes/contributor-site/tree/workshop/content/en/workshop/CONTRIBUTING.md#list-of-segments) - -For example - -``why-contribute`` +Upload your recording to the Google Drive folder provided for the Workshop Videos. ### Updating Youtube diff --git a/mentoring/programs/contributor-workshop/resources/templates/segment-template.md b/mentoring/programs/contributor-workshop/resources/templates/segment-template.md index e7d9edd0..dc413799 100644 --- a/mentoring/programs/contributor-workshop/resources/templates/segment-template.md +++ b/mentoring/programs/contributor-workshop/resources/templates/segment-template.md @@ -1,6 +1,6 @@ --- title: "Segment Name" # The name of the page -weight: 0 # Ordering of the page +weight: 2 # Ordering of the page description: | A brief description of what this segment aims to cover. --- -- cgit v1.2.3 From fc147a0420f101c684e3ff7582f0c1eb25071e4a Mon Sep 17 00:00:00 2001 From: Alison Dowdney Date: Wed, 23 Jun 2021 12:20:46 +0100 Subject: Add comment about removing old video from the playlist --- .../programs/contributor-workshop/resources/guides/videouploadguide.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'mentoring/programs') diff --git a/mentoring/programs/contributor-workshop/resources/guides/videouploadguide.md b/mentoring/programs/contributor-workshop/resources/guides/videouploadguide.md index 1e7c582e..147bb070 100644 --- a/mentoring/programs/contributor-workshop/resources/guides/videouploadguide.md +++ b/mentoring/programs/contributor-workshop/resources/guides/videouploadguide.md @@ -94,4 +94,4 @@ Close the comment section of the deprecated video ## Update the Playlist -Update the youtube playlist with the segment recording. +Update the youtube playlist with the segment recording. Remove the previous version of the video from the playlist if it exists. -- cgit v1.2.3 From a09ecf0898138c4ce8b010bde7515e2d89e3e5d9 Mon Sep 17 00:00:00 2001 From: Alison Dowdney Date: Wed, 23 Jun 2021 12:31:23 +0100 Subject: Restructure --- mentoring/programs/contributor-workshop/README.md | 7 +- .../programs/contributor-workshop/guides/README.md | 41 +++ .../contributor-workshop/guides/obssettings.png | Bin 0 -> 75253 bytes .../guides/presenterexitfullscreen.png | Bin 0 -> 37848 bytes .../guides/presenterfullscreen.png | Bin 0 -> 52239 bytes .../contributor-workshop/guides/presenterview.png | Bin 0 -> 33964 bytes .../guides/presenterviewandslides.png | Bin 0 -> 638041 bytes .../guides/presenterwindowed.png | Bin 0 -> 28083 bytes .../contributor-workshop/guides/slidesnotabs.png | Bin 0 -> 240719 bytes .../contributor-workshop/guides/slideswithtabs.png | Bin 0 -> 495569 bytes .../guides/updating-segment.md | 57 ++++ .../contributor-workshop/guides/videoguide.md | 293 +++++++++++++++++++++ .../guides/videouploadguide.md | 97 +++++++ .../contributor-workshop/live-workshop/README.md | 39 +++ .../live-workshop/build-and-test.md | 27 ++ .../live-workshop/community-groups.md | 27 ++ .../live-workshop/contributor-paths.md | 26 ++ .../live-workshop/first-issue-help.md | 31 +++ .../live-workshop/how-we-communicate.md | 33 +++ .../live-workshop/labels-and-bots.md | 25 ++ .../live-workshop/live-pr-demo.md | 24 ++ .../live-workshop/new-contributor-workshop-lead.md | 54 ++++ .../live-workshop/playground-exercise.md | 28 ++ .../live-workshop/repo-tour.md | 24 ++ .../live-workshop/workspace-setup.md | 24 ++ .../contributor-workshop/resources/README.md | 6 - .../resources/guides/README.md | 41 --- .../resources/guides/obssettings.png | Bin 75253 -> 0 bytes .../resources/guides/presenterexitfullscreen.png | Bin 37848 -> 0 bytes .../resources/guides/presenterfullscreen.png | Bin 52239 -> 0 bytes .../resources/guides/presenterview.png | Bin 33964 -> 0 bytes .../resources/guides/presenterviewandslides.png | Bin 638041 -> 0 bytes .../resources/guides/presenterwindowed.png | Bin 28083 -> 0 bytes .../resources/guides/slidesnotabs.png | Bin 240719 -> 0 bytes .../resources/guides/slideswithtabs.png | Bin 495569 -> 0 bytes .../resources/guides/updating-segment.md | 57 ---- .../resources/guides/videoguide.md | 293 --------------------- .../resources/guides/videouploadguide.md | 97 ------- .../resources/live-workshop/README.md | 39 --- .../resources/live-workshop/build-and-test.md | 27 -- .../resources/live-workshop/community-groups.md | 27 -- .../resources/live-workshop/contributor-paths.md | 26 -- .../resources/live-workshop/first-issue-help.md | 31 --- .../resources/live-workshop/how-we-communicate.md | 33 --- .../resources/live-workshop/labels-and-bots.md | 25 -- .../resources/live-workshop/live-pr-demo.md | 24 -- .../live-workshop/new-contributor-workshop-lead.md | 54 ---- .../resources/live-workshop/playground-exercise.md | 28 -- .../resources/live-workshop/repo-tour.md | 24 -- .../resources/live-workshop/workspace-setup.md | 24 -- .../resources/templates/segment-template.md | 33 --- .../templates/segment-template.md | 33 +++ 52 files changed, 888 insertions(+), 891 deletions(-) create mode 100644 mentoring/programs/contributor-workshop/guides/README.md create mode 100644 mentoring/programs/contributor-workshop/guides/obssettings.png create mode 100644 mentoring/programs/contributor-workshop/guides/presenterexitfullscreen.png create mode 100644 mentoring/programs/contributor-workshop/guides/presenterfullscreen.png create mode 100644 mentoring/programs/contributor-workshop/guides/presenterview.png create mode 100644 mentoring/programs/contributor-workshop/guides/presenterviewandslides.png create mode 100644 mentoring/programs/contributor-workshop/guides/presenterwindowed.png create mode 100644 mentoring/programs/contributor-workshop/guides/slidesnotabs.png create mode 100644 mentoring/programs/contributor-workshop/guides/slideswithtabs.png create mode 100644 mentoring/programs/contributor-workshop/guides/updating-segment.md create mode 100644 mentoring/programs/contributor-workshop/guides/videoguide.md create mode 100644 mentoring/programs/contributor-workshop/guides/videouploadguide.md create mode 100644 mentoring/programs/contributor-workshop/live-workshop/README.md create mode 100644 mentoring/programs/contributor-workshop/live-workshop/build-and-test.md create mode 100644 mentoring/programs/contributor-workshop/live-workshop/community-groups.md create mode 100644 mentoring/programs/contributor-workshop/live-workshop/contributor-paths.md create mode 100644 mentoring/programs/contributor-workshop/live-workshop/first-issue-help.md create mode 100644 mentoring/programs/contributor-workshop/live-workshop/how-we-communicate.md create mode 100644 mentoring/programs/contributor-workshop/live-workshop/labels-and-bots.md create mode 100644 mentoring/programs/contributor-workshop/live-workshop/live-pr-demo.md create mode 100644 mentoring/programs/contributor-workshop/live-workshop/new-contributor-workshop-lead.md create mode 100644 mentoring/programs/contributor-workshop/live-workshop/playground-exercise.md create mode 100644 mentoring/programs/contributor-workshop/live-workshop/repo-tour.md create mode 100644 mentoring/programs/contributor-workshop/live-workshop/workspace-setup.md delete mode 100644 mentoring/programs/contributor-workshop/resources/README.md delete mode 100644 mentoring/programs/contributor-workshop/resources/guides/README.md delete mode 100644 mentoring/programs/contributor-workshop/resources/guides/obssettings.png delete mode 100644 mentoring/programs/contributor-workshop/resources/guides/presenterexitfullscreen.png delete mode 100644 mentoring/programs/contributor-workshop/resources/guides/presenterfullscreen.png delete mode 100644 mentoring/programs/contributor-workshop/resources/guides/presenterview.png delete mode 100644 mentoring/programs/contributor-workshop/resources/guides/presenterviewandslides.png delete mode 100644 mentoring/programs/contributor-workshop/resources/guides/presenterwindowed.png delete mode 100644 mentoring/programs/contributor-workshop/resources/guides/slidesnotabs.png delete mode 100644 mentoring/programs/contributor-workshop/resources/guides/slideswithtabs.png delete mode 100644 mentoring/programs/contributor-workshop/resources/guides/updating-segment.md delete mode 100644 mentoring/programs/contributor-workshop/resources/guides/videoguide.md delete mode 100644 mentoring/programs/contributor-workshop/resources/guides/videouploadguide.md delete mode 100644 mentoring/programs/contributor-workshop/resources/live-workshop/README.md delete mode 100644 mentoring/programs/contributor-workshop/resources/live-workshop/build-and-test.md delete mode 100644 mentoring/programs/contributor-workshop/resources/live-workshop/community-groups.md delete mode 100644 mentoring/programs/contributor-workshop/resources/live-workshop/contributor-paths.md delete mode 100644 mentoring/programs/contributor-workshop/resources/live-workshop/first-issue-help.md delete mode 100644 mentoring/programs/contributor-workshop/resources/live-workshop/how-we-communicate.md delete mode 100644 mentoring/programs/contributor-workshop/resources/live-workshop/labels-and-bots.md delete mode 100644 mentoring/programs/contributor-workshop/resources/live-workshop/live-pr-demo.md delete mode 100644 mentoring/programs/contributor-workshop/resources/live-workshop/new-contributor-workshop-lead.md delete mode 100644 mentoring/programs/contributor-workshop/resources/live-workshop/playground-exercise.md delete mode 100644 mentoring/programs/contributor-workshop/resources/live-workshop/repo-tour.md delete mode 100644 mentoring/programs/contributor-workshop/resources/live-workshop/workspace-setup.md delete mode 100644 mentoring/programs/contributor-workshop/resources/templates/segment-template.md create mode 100644 mentoring/programs/contributor-workshop/templates/segment-template.md (limited to 'mentoring/programs') diff --git a/mentoring/programs/contributor-workshop/README.md b/mentoring/programs/contributor-workshop/README.md index 4b29b838..79941250 100644 --- a/mentoring/programs/contributor-workshop/README.md +++ b/mentoring/programs/contributor-workshop/README.md @@ -16,13 +16,16 @@ The umbrella issue tracking getting this initiative available to the public is [ ## Getting Involved -* Read the guides on contributing to the Contributor Workshop -[Contributing to the Contributor Workshop](resources/guides/README.md) +* Read the guides on [Contributing to the Contributor Workshop](guides/README.md) * Attend the bi-weekly mentoring meeting * Join the discussion in #contributor-workshop-dev on Kubernetes Slack +## Other Resources + +[live-workshop](live-workshop/README.md) - Resources for running a live contributor workshop + ## Previous Live Workshops * [2019 NA Contributor Summit NCW](https://www.youtube.com/watch?v=uUJrGwAom-E&list=PL69nYSiGNLP0OWp38tPBc-jSlMmwWr6Ci&index=16) (Videos in playlist, links to first NCW video) diff --git a/mentoring/programs/contributor-workshop/guides/README.md b/mentoring/programs/contributor-workshop/guides/README.md new file mode 100644 index 00000000..7280f8ac --- /dev/null +++ b/mentoring/programs/contributor-workshop/guides/README.md @@ -0,0 +1,41 @@ +# Contributing to the Contributor Workshop + +## Overview + +This folder contains guides and information on how to contribute to the Contributor Workshop. + +## Workshop Structure + +The workshop is divided into segments. These segments exist as individual pages in the ``content/en/docs/workshop`` directory on the branch ``workshop`` in the ``contributor-site`` repo. + +Each of these segments contain: + +* Written information +* One or more Exercises + +and may contain a video version of the written information. + +## Guides + +### [Updating & Creating Segments](updating-segment.md) + +How to update and create segments on the contributor site + +### [Video Recording Guide for Contributor Workshop Segments](videoguide.md) + +How to structure, record, upload and update video guides associated with workshop segments. + +## Glossary of Terms + +### Segment + +A page in the workshop directory covering a particular section of the Contributor Workshop. +This page may contain + +* Written information +* Video version of the segment +* Hands on exercise + +### Exercise + +A step by step, hands on activity within a segment. diff --git a/mentoring/programs/contributor-workshop/guides/obssettings.png b/mentoring/programs/contributor-workshop/guides/obssettings.png new file mode 100644 index 00000000..b8946ccd Binary files /dev/null and b/mentoring/programs/contributor-workshop/guides/obssettings.png differ diff --git a/mentoring/programs/contributor-workshop/guides/presenterexitfullscreen.png b/mentoring/programs/contributor-workshop/guides/presenterexitfullscreen.png new file mode 100644 index 00000000..0752c73f Binary files /dev/null and b/mentoring/programs/contributor-workshop/guides/presenterexitfullscreen.png differ diff --git a/mentoring/programs/contributor-workshop/guides/presenterfullscreen.png b/mentoring/programs/contributor-workshop/guides/presenterfullscreen.png new file mode 100644 index 00000000..8a6b81cb Binary files /dev/null and b/mentoring/programs/contributor-workshop/guides/presenterfullscreen.png differ diff --git a/mentoring/programs/contributor-workshop/guides/presenterview.png b/mentoring/programs/contributor-workshop/guides/presenterview.png new file mode 100644 index 00000000..252c25df Binary files /dev/null and b/mentoring/programs/contributor-workshop/guides/presenterview.png differ diff --git a/mentoring/programs/contributor-workshop/guides/presenterviewandslides.png b/mentoring/programs/contributor-workshop/guides/presenterviewandslides.png new file mode 100644 index 00000000..f3e88d60 Binary files /dev/null and b/mentoring/programs/contributor-workshop/guides/presenterviewandslides.png differ diff --git a/mentoring/programs/contributor-workshop/guides/presenterwindowed.png b/mentoring/programs/contributor-workshop/guides/presenterwindowed.png new file mode 100644 index 00000000..653d76ce Binary files /dev/null and b/mentoring/programs/contributor-workshop/guides/presenterwindowed.png differ diff --git a/mentoring/programs/contributor-workshop/guides/slidesnotabs.png b/mentoring/programs/contributor-workshop/guides/slidesnotabs.png new file mode 100644 index 00000000..1b41c84b Binary files /dev/null and b/mentoring/programs/contributor-workshop/guides/slidesnotabs.png differ diff --git a/mentoring/programs/contributor-workshop/guides/slideswithtabs.png b/mentoring/programs/contributor-workshop/guides/slideswithtabs.png new file mode 100644 index 00000000..e82882a2 Binary files /dev/null and b/mentoring/programs/contributor-workshop/guides/slideswithtabs.png differ diff --git a/mentoring/programs/contributor-workshop/guides/updating-segment.md b/mentoring/programs/contributor-workshop/guides/updating-segment.md new file mode 100644 index 00000000..1b4f3e37 --- /dev/null +++ b/mentoring/programs/contributor-workshop/guides/updating-segment.md @@ -0,0 +1,57 @@ +# Updating workshop segments + +This guide covers how to update segments in the Contributor Workshop. + +- [Updating workshop segments](#updating-workshop-segments) + - [Prerequisites](#prerequisites) + - [Fork & Clone the ``contributor-site``](#fork--clone-the-contributor-site) + - [Checkout a branch off the workshop branch for your changes](#checkout-a-branch-off-the-workshop-branch-for-your-changes) + - [Run the site locally with your changes](#run-the-site-locally-with-your-changes) + - [Modifying an existing segment](#modifying-an-existing-segment) + - [Adding a segment to the workshop](#adding-a-segment-to-the-workshop) + - [Adding a video guide to accompany a segment](#adding-a-video-guide-to-accompany-a-segment) + - [Save, Commit, Push, PR](#save-commit-push-pr) + +## Prerequisites + +### Fork & Clone the ``contributor-site`` + +Create a fork of the [``contributor-site``](https://github.com/kubernetes/contributor-site/tree/workshop) repo. + +Clone your fork locally + +### Checkout a branch off the workshop branch for your changes + +```bash +git checkout workshop + +git checkout -b my-changes +``` + +### Run the site locally with your changes + +Follow the instructions in the top level [``README.md``](https://github.com/kubernetes/contributor-site/tree/master/README.md#running-the-site-locally) on the contributor-site. + +You're now ready to update and add segments! + +## Modifying an existing segment + +Find the file you would like to edit and open it. See [the list of segments](https://github.com/kubernetes/contributor-site/tree/workshop/content/en/workshop/CONTRIBUTING.md#list-of-segments). + +## Adding a segment to the workshop + +Make sure to update [the list of segments](https://github.com/kubernetes/contributor-site/tree/workshop/content/en/workshop/CONTRIBUTING.md#list-of-segments), with the new page. + +If inserting a page between existing pages, make sure to update the page weightings in the frontmatter and [the list of segments](https://github.com/kubernetes/contributor-site/tree/workshop/content/en/workshop/CONTRIBUTING.md#list-of-segments),. + +See [the segment template](../templates/segment-template.md), on how to structure your segment. + +## Adding a video guide to accompany a segment + +With some of the guides, we might want a youtube video to accompany them. You can find the information for adding a video to the guide, in the [video guide](videoguide.md) + +## Save, Commit, Push, PR + +Once you've made the modifications and additions you want, commit and push them to your fork. + +Then make a pull request of your changes into the ``workshop`` branch of the ``contributor-site`` repo. diff --git a/mentoring/programs/contributor-workshop/guides/videoguide.md b/mentoring/programs/contributor-workshop/guides/videoguide.md new file mode 100644 index 00000000..13094925 --- /dev/null +++ b/mentoring/programs/contributor-workshop/guides/videoguide.md @@ -0,0 +1,293 @@ + +# Video Recording Guide for Contributor Workshop Segments + +This guide covers, how to structure, record, upload and update video guides associated with workshop segments. + +- [Format / Video Style](#format--video-style) +- [Encoding Guidelines](#encoding-guidelines) + - [Zoom Recording](#zoom-recording) + - [OBS](#obs) + - [Streamyard](#streamyard) + - [Adobe Media Encoder](#adobe-media-encoder) +- [Recording Guides](#recording-guides) + - [Record Using Zoom](#record-using-zoom) + - [Install Windowed extension (optional)](#install-windowed-extension-optional) + - [Start the meeting](#start-the-meeting) + - [Setting up slides for recording](#setting-up-slides-for-recording) + - [Without browser extension](#without-browser-extension) + - [With browser extension](#with-browser-extension) + - [Note : Exiting the windowed mode](#note--exiting-the-windowed-mode) + - [Adding your facecam](#adding-your-facecam) + - [Unmute your audio](#unmute-your-audio) + - [Recording in Zoom](#recording-in-zoom) + - [Note : Do a test recording first](#note--do-a-test-recording-first) + - [How to record](#how-to-record) + - [Recording in OBS](#recording-in-obs) + - [Recording in Streamyard](#recording-in-streamyard) +- [Updating / Adding video to a segment](#updating--adding-video-to-a-segment) + - [Rename your recording](#rename-your-recording) + - [Upload your video to Google Drive](#upload-your-video-to-google-drive) + - [Updating Youtube](#updating-youtube) +- [Update the Segment page with video](#update-the-segment-page-with-video) +- [Best Practices & Recommendations](#best-practices--recommendations) + - [Video](#video) + - [Camera Type](#camera-type) + - [Audio](#audio) + - [Microphone Types](#microphone-types) + - [Sound Environment](#sound-environment) + - [Background Noise](#background-noise) + - [Removing Background noise in Zoom](#removing-background-noise-in-zoom) + - [Removing Background noise with Krisp](#removing-background-noise-with-krisp) + - [Removing Background noise with NVIDIA Broadcast or RTX Voice](#removing-background-noise-with-nvidia-broadcast-or-rtx-voice) + - [Other Tips](#other-tips) + - [Screensharing](#screensharing) + - [Hardware](#hardware) + - [Headset Microphones](#headset-microphones) + - [External Microphones](#external-microphones) + - [Webcams](#webcams) + - [Presentation remotes](#presentation-remotes) + +## Format / Video Style + +You can use any format/style as long as the same information in the guide is captured in the video. Slides, A screenshare, green screen yourself into the repo even! Be creative. + +## Encoding Guidelines + +### Zoom Recording + +Handled by zoom, Can't change these settings. + +### OBS + +![OBS Settings](obssettings.png) + +### Streamyard + +Handled by Streamyard, Can't change these settings. + +### Adobe Media Encoder + +use Youtube 1080p Full HD + +## Recording Guides + +Guides on how to record a presentation style video (slides/screen,facecam) + +### Record Using Zoom + +#### Install Windowed extension (optional) + +This makes it easier for you to share the slides to zoom. Allows you to pop out the fullscreen view to a single window. + +[GitHub Link](https://github.com/dralletje/Windowed) + +#### Start the meeting + +Start a meeting in zoom (you can start and record a meeting with a single participant) + +#### Setting up slides for recording + +Open your slides in Presenter View + +![Presenter View](presenterview.png) + +It should open a presenter view, with a timer, slide notes, and change the tab from editor to a slideshow presentation + +![Presenter View and Slides](presenterviewandslides.png) + +You will use the presenter view to control the slides, and the slide view will be cast to the zoom call. + +##### Without browser extension + +Share the window which is displaying the slides view. + +![Slides with your tabs](slideswithtabs.png) + +##### With browser extension + +When moving your mouse on the slide view a small dialog with the slide number, and triple dots will appear. Select the triple dots and enter full screen + +![Enter Full Screen on Presentation](presenterfullscreen.png) + +After selecting the fullscreen option, you will be presented further options on how to display the slides. + +Select the windowed option + +![Windowed Fullscreen](presenterwindowed.png) + +A new window with only the slides will appear, Share this window in zoom. + +![Slides with no tabs](slidesnotabs.png) + +###### Note : Exiting the windowed mode + +To exit out of this view, and go back the editor, select the window with the slide view back into focus, move your mouse until the triple dots mentioned earlier appear. Select the triple dots again and ``Exit Full Screen`` + +![Exit Full Screen](presenterexitfullscreen.png) + +#### Adding your facecam + +If you haven't done so already, start your video in Zoom. + +#### Unmute your audio + +If you haven't done so already, unmute your audio in Zoom. + +#### Recording in Zoom + +Now that you've got your slides, video and audio setup, you're ready to record! + +##### Note : Do a test recording first + +It's good practice to create a test recording of your whole setup in action. +If you change shares between windows, check that changing the shares appears how you want it to in the video. + +##### How to record + +Select the ``Record`` button in zoom. + +If you have the option between saving locally, and in the cloud, select locally. + +Once you have finished recording, end the meeting. + +A popup should appear with progress on converting the recording. +Once the recording is converted, a file browser window with the recording will be opened. Rename the recording from ``zoom_0.mp4`` to the format described in [Rename your recording](#rename-your-recording) + +### Recording in OBS + +Coming soon + +### Recording in Streamyard + +Coming soon + +## Updating / Adding video to a segment + +### Rename your recording + +Rename your recording to ``YYYY-MM-DD--.mp4`` + +Where + +- ``YYYY-MM-DD`` being date, is the date video was recorded +- ```` being the name of the markdown file associated with that segment. see [CONTRIBUTING.md](https://github.com/kubernetes/contributor-site/tree/workshop/content/en/workshop/CONTRIBUTING.md#list-of-segments) +- ```` being the github handle of the person who recorded the video, if there are multiple presenters just add another dash and the handle. ``-`` + +For example + +``2021-05-10-why-contribute-alisondy.mp4`` + +``2021-05-10-why-contribute-alisondy-mrbobbytables.mp4`` + +### Upload your video to Google Drive + +Upload your recording to the Google Drive folder provided for the Workshop Videos. + +### Updating Youtube + +Once you have uploaded the video to drive, contact one of the [youtube admins](/communication/moderators.md#youtube-channel) to upload it to the Kubernetes YouTube channel. + +> Youtube Admins see [Video Upload Guide](videouploadguide.md) for details about uploading the segment to youtube + +## Update the Segment page with video + +If adding to a segment page where video doesn't exist, Paste this at the top, after the frontmatter. Fill in the details with the youtube id of the video you just uploaded. + +If adding to a segment page where a video already exists, update the youtube id in the shortcode, with the video id of your newly uploaded video. + +```txt +## Video Walkthrough + +{{< youtube id="" title="Contributor Workshop : }} +``` + +## Best Practices & Recommendations + +### Video + +#### Camera Type + +Use an external camera or webcam to capture your video. + +Built in webcams restrict the angle of you webcam, to the viewing angle of your display, and often provide a low quality image. + +- Use an external webcam. 1080p preferred or 720p at a minimum. Typically, either will be better quality than the built-in camera on your laptop. +- Lighting - Adjusting your lighting may help you get a better camera feed in less than optimal lighting conditions. + - Optimize the ambient lighting within your space first. + - There should be no window or strong light source behind you that darkens your face + - There should be no strong light source from one side that casts a shadow on the opposite side of your face. + - Good ambient lighting from your ceiling lights or windows may be enough as long as they are in front of you. + - Diffused lighting is better than harsh, direct lighting. +- Background – keep it clean and uncluttered. It’s great to show off your personality/style in your home, just be sure to keep everything appropriate for a general audience and compliant with the Code of Conduct. A plain wall is also just fine, no need to overdo it. +- Camera Position - as close as possible at your eye level, not pointing up towards your nose or the ceiling, or down towards the floor. It can be as simple as raising your laptop via a few books. Or if you have an external webcam, position it on the top edge or close to the top of the screen from which you are advancing your slides/notes. +- Keep eye contact with the camera just like you would look at your audience during an in-person presentation. It's okay to look away for brief moments, just make sure you look towards the camera for the majority of the presentation. +- Video with more lighting tips [https://youtu.be/rGcAM1CNEU0](https://youtu.be/rGcAM1CNEU0) + +### Audio + +#### Microphone Types + +**Best:** External microphone (condenser recommended over dynamic*) via a USB connection or DAC. This type of microphone will pick up audio from a distance as well as up close really well. This means you can position it a fair distance away from yourself when recording. If using one of these microphones, try to position it out of frame from your video. + +**Good:** Headset Microphone, this could be a microphone located on the wires like on mobile earphones, the mic on your wireless earphones as well as the usual fold down microphone on a headset. All of these assist with isolating microphone pick-up from ambient noises within your recording/streaming space. Wired headsets will give you better quality audio than wireless. + +**Acceptable:** External microphone built into your webcam. Often better quality than your built-in laptop microphone. + +**Worst:** Your built-in laptop microphone. These are generally low-quality microphones, and they have little or no ability to filter out background noise. + +#### Sound Environment + +##### Background Noise + +It’s best to be in a controlled environment with little to no background noise. +If this is not possible you can use your recording software and other software to remove background noise. +Another option to filtering out background noise or being in a controlled environment is using push to talk, or unmuting your mic whenever you need to speak. + +###### Removing Background noise in Zoom + +In zoom settings under ``Audio`` +Change the Suppress background noise setting to ``High`` + +###### Removing Background noise with Krisp + +Krisp provides AI powered background noise cancellation, see [krisp.ai](https://krisp.ai/) for more information. + +###### Removing Background noise with NVIDIA Broadcast or RTX Voice + +If you're using Windows, and are using certain models of NVIDIA GPU, you can install either NVIDIA Broadcast or RTX Voice to filter out background noise. See [RTX Voice setup guide](https://www.nvidia.com/en-us/geforce/guides/nvidia-rtx-voice-setup-guide/) and [Broadcast app setup guide](https://www.nvidia.com/en-gb/geforce/guides/broadcast-app-setup-guide/) for more information. + +##### Other Tips + +- Mute all notifications and programs not being recorded +- Disable any unnecessary audio devices + +### Screensharing + +- Increase the font size when sharing terminals, text editors +- Ensure you have all the windows you need opened before recording. +- Export any sensitive variables needed in your terminals before starting your presentation +- If using a passworded ssh key, Start a ssh-agent in the terminal beforehand. + +### Hardware + +Here are some equipment recommendations from the CNCF: + +#### Headset Microphones + +Logitech / Plantronics – i.e. Logitech H111 / Logitech H390 / Plantronics C225 + +#### External Microphones + +Blue / Samson – i.e. Blue Snowball / Blue Yeti / Samson Meteor / Samson G-Track + +#### Webcams + +Good value – Logitech C920 + +More info – [https://www.tomsguide.com/news/where-to-buy-webcams-now-these-retailers-have-stock](https://www.tomsguide.com/news/where-to-buy-webcams-now-these-retailers-have-stock) + +#### Presentation remotes + +Logitech / Canon / Kensington / SMK + +Tested and recommended for PC or Mac – Logitech R400, R800, Spotlight / Canon PR500, PR100 diff --git a/mentoring/programs/contributor-workshop/guides/videouploadguide.md b/mentoring/programs/contributor-workshop/guides/videouploadguide.md new file mode 100644 index 00000000..147bb070 --- /dev/null +++ b/mentoring/programs/contributor-workshop/guides/videouploadguide.md @@ -0,0 +1,97 @@ +# Segment Upload Guide for Youtube Admins + +## Upload the new video + +In youtube, upload the same video and title it as follows + +```txt +Contributor Workshop : with | +``` + +For example + +```txt +Contributor Workshop : Why Contribute? with @alisondy | May 2021 +``` + +## Adding the thumbnail image + +```markdown +TODO : Instructions on how to generate a thumbnail image, similar to https://gist.github.com/alisondy/e4ff3b483a32330ade0c880b4a4a10b1 +``` + +Set the thumbnail to the image generated in the previous step + +## Setting the description + +Use the following template for setting the video description + +```txt +This is the video guide for the Contributor Workshop segment + +Link to this segments page: +https://kubernetes.dev/docs/workshop/ + +Link to the workshop: +https://kubernetes.dev/docs/workshop/ +``` + +## Update the previous video for the segment if it exists + +If you're updating an already existing video, follow the next steps to update the following on the previous video + +- title +- thumbnail +- description +- comments section + +## Update the title + +Update the title on the previous video to match the following format + +```txt +Contributor Workshop : | | 🚨🚨 DEPRECATED 🚨🚨 +``` + +For example + +```txt +Contributor Workshop : Why Contribute? with @alisondy | May 2021 | 🚨🚨 DEPRECATED 🚨🚨 +``` + +## Update the thumbnail image + +Update the Thumbnail image on the previous video to + +insert-deprecation-thumbnail-here.jpeg + +```txt + + +THIS VIDEO IS DEPRECATED! +See the comments & description for details on where to find the new video guide! + + +``` + +## Update the Description + +On the previous video, add the following to the start of the description + +```txt +🚨🚨 DEPRECATED , Please see 🚨🚨 +``` + +## Update the Comments + +On the previous video, add the following as a comment as Kubernetes YT & pin to the top of the comments + +```txt +🚨🚨 DEPRECATED , Please see 🚨🚨 +``` + +Close the comment section of the deprecated video + +## Update the Playlist + +Update the youtube playlist with the segment recording. Remove the previous version of the video from the playlist if it exists. diff --git a/mentoring/programs/contributor-workshop/live-workshop/README.md b/mentoring/programs/contributor-workshop/live-workshop/README.md new file mode 100644 index 00000000..3958d322 --- /dev/null +++ b/mentoring/programs/contributor-workshop/live-workshop/README.md @@ -0,0 +1,39 @@ +# Live Workshops Resources + +## Overview + +This folder contains the [handbook for the New Contributor Workshop Content Lead](./new-contributor-workshop-lead.md) as well as playbooks for each of the Contributor Workshop sessions in a live setting. + +This workshop is held periodically by the Kubernetes Community, but materials and processes may be used at contributor focused summits and events anywhere. + +Slides from previous New Contributor Workshops can be found [here](https://github.com/cncf/presentations/blob/master/kubernetes/README.md#kubernetes-new-contributor-workshops). + +## Sample Track for Beginner Workshop + +This workshop is meant for folks who have never contributed to opensource before and/or need help setting up a Kubernetes developer environment. + +1. Welcome +1. [Live PR Demo](./live-pr-demo.md) +1. [Paths to Contributorship](./contributor-paths.md) +1. [Communication in the Kubernetes Community](./how-we-communicate.md) +1. [Community Group and Governance Overview](./community-groups.md) +1. [Kubernetes Orgs Overview](./repo-tour.md) +1. [Workspace Setup](./workspace-setup.md) +1. [Local Build&Test](./build-and-test.md) +1. [Pull Request Exercise](./playground-exercise.md) +1. [Find Your First Issue](./first-issue-help.md) + +## Sample Track for Intermediate Workshop + +This workshop differs from the Beginner workshop in that participants are expected to have a working Docker/Kubernetes/Go setup. They have a basic understanding of how opensource contributions work, and may have opened a PR against Kubernetes before. + +1. Welcome +1. [Live PR Demo](./live-pr-demo.md) +1. [Paths to Contributorship](./contributor-paths.md) +1. [Communication in the Kubernetes Community](./how-we-communicate.md) +1. [Community Group and Governance Overview](./community-groups.md) +1. [Kubernetes Orgs Overview](./repo-tour.md) +1. k/k Walkthrough +1. [Local Build&Test](./build-and-test.md) +1. [Labels, Bots and Git Workflow](./labels-and-bots.md) +1. [Find Your First Issue](./first-issue-help.md) diff --git a/mentoring/programs/contributor-workshop/live-workshop/build-and-test.md b/mentoring/programs/contributor-workshop/live-workshop/build-and-test.md new file mode 100644 index 00000000..147d91a3 --- /dev/null +++ b/mentoring/programs/contributor-workshop/live-workshop/build-and-test.md @@ -0,0 +1,27 @@ +## Build and Test + +### Duration + +40-60 minutes, depending on beginner vs intermediate participants + +### Task Overview + +Build Kubernetes binaries locally, and do some fun things with them. + +**Important** Have facilitators to help with technical issues (2-3 is enough for Intermediate, you want 5 for Beginner) + +### Slides + +Clear command line instructions. + +### Details To Cover + +- This is the hands-on part. Details are up to you; look to previous workshops for inspiration. +- Adjust difficulty based on whether this is the Beginner or Intermediate workshop. +- It is _extremely important_ to run this part of the workshop several times previously, and to make sure that versions match those in the [workspace setup](./workspace-setup.md). + +### Ideas + +- Do a fun thing with the Kubernetes [go client](https://git.k8s.io/client-go) and a [kind](https://sigs.k8s.io/kind) cluster. +- Build and modify `kubectl`. +- Try a `make` command; be aware you may need to give docker a lot of space on your machine for a successful build. diff --git a/mentoring/programs/contributor-workshop/live-workshop/community-groups.md b/mentoring/programs/contributor-workshop/live-workshop/community-groups.md new file mode 100644 index 00000000..01a8c80c --- /dev/null +++ b/mentoring/programs/contributor-workshop/live-workshop/community-groups.md @@ -0,0 +1,27 @@ +## Community Groups + +### Duration + +15 minutes + +### Task Overview + +Introduce SIGs, Working Groups, and a tiny bit of governance (if you must). + +### Slides + +Refer to previous workshops for inspirations. + +### Details To Cover + +- SIGs +- Subprojects +- Working Groups +- User Groups +- Committees +- How to Join Any Of The Above + +### Ideas + +- Stay simple. Don't make it too complicated. +- Ask participants to define a few example SIGs via audience interaction. \ No newline at end of file diff --git a/mentoring/programs/contributor-workshop/live-workshop/contributor-paths.md b/mentoring/programs/contributor-workshop/live-workshop/contributor-paths.md new file mode 100644 index 00000000..d14691eb --- /dev/null +++ b/mentoring/programs/contributor-workshop/live-workshop/contributor-paths.md @@ -0,0 +1,26 @@ +## Contributor Paths + +### Duration + +10-30 minutes + +### Task Overview + +This is about contributor origin stories. + +### Slides + +Refer to previous workshops for inspirations + +### Details To Cover + +- Who can contribute? +- What skills are needed? +- How to Fit Contributions Into Your Job +- Balance knowledge with learning and the needs of the project + +### Ideas + +- Share some contributor origin stories +- Ask the room why they are at the workshop +- Have a few people share their thoughts diff --git a/mentoring/programs/contributor-workshop/live-workshop/first-issue-help.md b/mentoring/programs/contributor-workshop/live-workshop/first-issue-help.md new file mode 100644 index 00000000..b99488af --- /dev/null +++ b/mentoring/programs/contributor-workshop/live-workshop/first-issue-help.md @@ -0,0 +1,31 @@ +## Finding Your First Issue + +### Duration + +20 minutes + +### Task Overview + +Set participants on as much of a paved path to contributor success as possible. +At this point in the workshop, participants should know what kind of issue they want to tackle. + +### Slides + +Refer to previous workshops for inspirations + +### Details To Cover + +- help-wanted and good-first-issue labels +- Up and coming sandbox projects +- Working with your SIG +- Refer participants to specific SIGs +- How to "claim" an issue (since non-members cannot self-assign) +- Path to [membership](/community-membership.md) + +### Ideas + +- Give folks time to discuss and help each other +- Gather information from SIGs in advance (via Slack, Twitter...) on who needs help, and at what level +- Prepare a list of issues and assign folks right there +- Connect participants to mentoring tracks if available (e.g. Release Team Shadow) + diff --git a/mentoring/programs/contributor-workshop/live-workshop/how-we-communicate.md b/mentoring/programs/contributor-workshop/live-workshop/how-we-communicate.md new file mode 100644 index 00000000..777929e2 --- /dev/null +++ b/mentoring/programs/contributor-workshop/live-workshop/how-we-communicate.md @@ -0,0 +1,33 @@ +## How We Communicate + +### Duration + +10-30 minutes + +### Task Overview + +Show how we communicate in the community, and which tools are for what purpose. + +### Slides + +Refer to previous workshops for inspirations. + +### Details To Cover + +- [Code of Conduct](https://git.k8s.io/community/code-of-conduct.md) (CoC) +- Where We Talk: + - Slack + - Discuss +- How We Decide: + - GitHub + - Zoom + - Mailing List +- Calendar +- Meetups + +### Ideas + +- Have a #ncw channel on Slack. The first person who finds the Slack channel with the most members, or the longest name(etc) and posts in here wins a prize! +- Everyone introduces their neighbor and a cool Kubernetes fact about them in a Slack or Discuss channel/topic. +- Put an easter egg in the mailing list and whoever discovers it first by joining and reading the discussions, wins a prize! +- Come up with the most creative TL;DR for the CoC. \ No newline at end of file diff --git a/mentoring/programs/contributor-workshop/live-workshop/labels-and-bots.md b/mentoring/programs/contributor-workshop/live-workshop/labels-and-bots.md new file mode 100644 index 00000000..0e191f03 --- /dev/null +++ b/mentoring/programs/contributor-workshop/live-workshop/labels-and-bots.md @@ -0,0 +1,25 @@ +## Labels and Bots + +### Duration + +10 - 15 minutes + +### Task Overview + +Show the Kubernetes automation and PR workflow, as well as the bot command help page. +This task is meant as a short overview for Intermediate content. + +### Slides + +The [PR workflow diagram](https://git.k8s.io/community/blob/master/contributors/guide/git_workflow.png) is useful here. There are also previous slides that explain the differnet labels. + +### Details To Cover + +- Which labels are used how, and by whom? +- How to add labels +- Other bot commands +- Prow + +### Ideas + +- Play with bots in the [contributor playground](https://sigs.k8s.io/contributor-playground) diff --git a/mentoring/programs/contributor-workshop/live-workshop/live-pr-demo.md b/mentoring/programs/contributor-workshop/live-workshop/live-pr-demo.md new file mode 100644 index 00000000..27b6c97e --- /dev/null +++ b/mentoring/programs/contributor-workshop/live-workshop/live-pr-demo.md @@ -0,0 +1,24 @@ +## Live PR Demo + +### Duration + +Plan for about 30 minutes + +### Task Overview + +Demonstrate opening a pull request against the [Kubernetes/Kubernetes](https://git.k8s.io/kubernetes) (k/k) repository. There are some docs cleanup good-first-issues, but feel free to show off something you've been working on for a while. + +### Slides + +None; this is a live demo. + +### Details To Cover + +- Make sure to prepare code in advance but only commit locally +- Show the k/k pull request workflow +- Show the PR templates and fill them out, explaining why +- Interact with the bot and briefly mention labels/OWNERS files +- Leave room for questions, but be aware that the workflow will be covered in depth later. + +### Ideas +- ask the audience or a pre-planned reviewer for code review, showing more of the k/k automation diff --git a/mentoring/programs/contributor-workshop/live-workshop/new-contributor-workshop-lead.md b/mentoring/programs/contributor-workshop/live-workshop/new-contributor-workshop-lead.md new file mode 100644 index 00000000..b6398d28 --- /dev/null +++ b/mentoring/programs/contributor-workshop/live-workshop/new-contributor-workshop-lead.md @@ -0,0 +1,54 @@ +# New Contributor Workshop Lead + +## Overview +The New Contributor Workshop Lead is in charge of planning and executing the New Contributor Workshop. They will coordinate with the overall Events Team and the organizers of related activities aimed at new contributors. + +## Skills and Qualifications + +The New Contributor Content Lead must be a current, active Kubernetes contributor who is knowledgeable of the community and organizational structure of the Kubernetes project, as well as familiar with building and developing Kubernetes. +They should have experience and be comfortable with teaching in a workshop setting and presenting interactively in front of an audience. +Additionally, they must be able to relate to and empathize with newcomers of many different experience levels. +As this role is part of a subproject of SIG-contributor-experience, the New Contributor Content Lead must be a member of SIG-contributor-experience. + +## Activities + +*These tasks reflect a rough timeline leading from the end of the previous New Contributor Workshop to the currently planned one.* +- Attend event planning meetings in preparation for the New Contributor Workshop, where applicable. +- Create a Workshop Content Proposal and link in an Issue to k/community: + - determine sessions and their overall topic (e.g. How We Communicate, Code Base Walkthrough, etc) + - determine what difficulty/experience levels will be offered, if any, and coordinate with Lead + - determine workshop capacity, and coordinate with Lead + - determine room requirements (size, number, table/chair layout, A/V) and coordinate with the planning team +- Coordinate with New Contributor Content Shadows to prepare them for leading this role. +- Recruit and coordinate with workshop teachers for any sessions/topics you do not wish to teach yourself (e.g. invite someone to speak on "Communication in the Kubernetes Project"). +- Make modifications and continuous improvements to the new contributor workshop template. +Incorporate feedback from previous New Contributor Workshops. +Shadows and co-presenters are expected to assist and review these updates. +[Past presentations are linked here](https://github.com/cncf/presentations/tree/master/kubernetes) - please make a copy of the existing deck before updating/editing. +- Work with Registration to: + - disseminate course materials (slides) in advance + - ensure participants sign the CLA + - ensure attendees meet technical and experience requirements for their course + - obtain a comprehensive list of names, emails, and GitHub handles +- Ensure to advertise the SIG-Intros. +- Solicit feedback from workshop participants. + +## Time Commitment + +1-2 hours/week most of the time, 4-5 in the weeks leading up to NCW, depending on previous teaching/shadowing experience. + +## Coupon Codes + +If you would like to share coupon codes for the CNCF store with your +attendees, please create an issue in the [kubernetes/funding] repo and +assign [SIG Contributor Experience chairs] for approval. + +The funding request should contain the following details: +- Number of coupon codes required +- Desired amount of each coupon code (e.g. $20) OR desired swags for each coupon code (e.g. 1 Tshirt, 2 stickers) + +Once the request is approved, the chairs will create a CNCF Service Desk +ticket to get the list of coupon codes. + +[kubernetes/funding]: https://github.com/kubernetes/funding +[SIG Contributor Experience chairs]: /sig-contributor-experience#chairs diff --git a/mentoring/programs/contributor-workshop/live-workshop/playground-exercise.md b/mentoring/programs/contributor-workshop/live-workshop/playground-exercise.md new file mode 100644 index 00000000..6aca9178 --- /dev/null +++ b/mentoring/programs/contributor-workshop/live-workshop/playground-exercise.md @@ -0,0 +1,28 @@ +## Playground Exercise + +### Duration + +30 - 50 minutes + +### Task Overview + +Give new contributors the experience of the Kubernetes GitHub workflow! +This task requires some setup and planning. + +Create a New Contributor Workshop folder specific to this event, with teachers' and participants' GitHub handles in the OWNERS file. +[Here is an example](https://sigs.k8s.io/contributor-playground/seattle). Make sure to obtain participants' GitHub handles from the event registrar in advance. +Issue and PR exercise ideas can be found [here](https://sigs.k8s.io/contributor-playground/exercises). + +### Slides + +Refer to previous workshops for inspirations. + +### Details To Cover + +- Labels and bot commands - more material [here](./labels-and-bots.md) +- Automation +- How to assign reviewers + +### Ideas + +- The first person to `/honk` on a PR wins a prize! diff --git a/mentoring/programs/contributor-workshop/live-workshop/repo-tour.md b/mentoring/programs/contributor-workshop/live-workshop/repo-tour.md new file mode 100644 index 00000000..d1f46ee0 --- /dev/null +++ b/mentoring/programs/contributor-workshop/live-workshop/repo-tour.md @@ -0,0 +1,24 @@ +## Repo Tour + +### Duration + +10 - 15 minutes + +### Task Overview + +Show that Kubernetes is not just about the Core Repository, but also about the other repos in the org and in kubernetes-sigs. + +### Slides + +Have a few overview slides, but also go off-book and live show the repos on GitHub. + +### Details To Cover + +- k/website, k/test-infra, k/community, k/enhancements, with explanations +- Exciting things in kubernetes-sigs + + +### Ideas + +- Ask participants if they have found or are interested in specific repos, and share about their purpose. +- Mention which repos need help, or have awesome good-first-issue shepherding from maintainers! \ No newline at end of file diff --git a/mentoring/programs/contributor-workshop/live-workshop/workspace-setup.md b/mentoring/programs/contributor-workshop/live-workshop/workspace-setup.md new file mode 100644 index 00000000..19dbef29 --- /dev/null +++ b/mentoring/programs/contributor-workshop/live-workshop/workspace-setup.md @@ -0,0 +1,24 @@ +## Workspace Setup + +### Duration + +Plan for 90- 120 minutes of download and setup time when on wifi. When on a workshop specific network, this may be much shortened. + +### Task Overview + +Make sure all Beginning Contributors have a workspace setup for hacking on Kubernetes. + +**Important** Have facilitators to help with technical issues (3-5 for ~30 people) + +### Slides + +Clear and large download commands to copy into the terminal. + +### Details To Cover + +- Make sure everyone has the correct setup for a local build and test demo. + +### Ideas + +- Have a dedicated workshop network. +- When internet is slow, start the download and prep process during earlier sessions, to make sure everyone is up to date. diff --git a/mentoring/programs/contributor-workshop/resources/README.md b/mentoring/programs/contributor-workshop/resources/README.md deleted file mode 100644 index 74356ac1..00000000 --- a/mentoring/programs/contributor-workshop/resources/README.md +++ /dev/null @@ -1,6 +0,0 @@ -# Contributor Workshop Resources - -This folder contains information on - -- How to contribute to the Contributor Workshop site -- How to run a "live" Contributor Workshop (see [``live-workshop``](live-workshop/README.md)) \ No newline at end of file diff --git a/mentoring/programs/contributor-workshop/resources/guides/README.md b/mentoring/programs/contributor-workshop/resources/guides/README.md deleted file mode 100644 index 7280f8ac..00000000 --- a/mentoring/programs/contributor-workshop/resources/guides/README.md +++ /dev/null @@ -1,41 +0,0 @@ -# Contributing to the Contributor Workshop - -## Overview - -This folder contains guides and information on how to contribute to the Contributor Workshop. - -## Workshop Structure - -The workshop is divided into segments. These segments exist as individual pages in the ``content/en/docs/workshop`` directory on the branch ``workshop`` in the ``contributor-site`` repo. - -Each of these segments contain: - -* Written information -* One or more Exercises - -and may contain a video version of the written information. - -## Guides - -### [Updating & Creating Segments](updating-segment.md) - -How to update and create segments on the contributor site - -### [Video Recording Guide for Contributor Workshop Segments](videoguide.md) - -How to structure, record, upload and update video guides associated with workshop segments. - -## Glossary of Terms - -### Segment - -A page in the workshop directory covering a particular section of the Contributor Workshop. -This page may contain - -* Written information -* Video version of the segment -* Hands on exercise - -### Exercise - -A step by step, hands on activity within a segment. diff --git a/mentoring/programs/contributor-workshop/resources/guides/obssettings.png b/mentoring/programs/contributor-workshop/resources/guides/obssettings.png deleted file mode 100644 index b8946ccd..00000000 Binary files a/mentoring/programs/contributor-workshop/resources/guides/obssettings.png and /dev/null differ diff --git a/mentoring/programs/contributor-workshop/resources/guides/presenterexitfullscreen.png b/mentoring/programs/contributor-workshop/resources/guides/presenterexitfullscreen.png deleted file mode 100644 index 0752c73f..00000000 Binary files a/mentoring/programs/contributor-workshop/resources/guides/presenterexitfullscreen.png and /dev/null differ diff --git a/mentoring/programs/contributor-workshop/resources/guides/presenterfullscreen.png b/mentoring/programs/contributor-workshop/resources/guides/presenterfullscreen.png deleted file mode 100644 index 8a6b81cb..00000000 Binary files a/mentoring/programs/contributor-workshop/resources/guides/presenterfullscreen.png and /dev/null differ diff --git a/mentoring/programs/contributor-workshop/resources/guides/presenterview.png b/mentoring/programs/contributor-workshop/resources/guides/presenterview.png deleted file mode 100644 index 252c25df..00000000 Binary files a/mentoring/programs/contributor-workshop/resources/guides/presenterview.png and /dev/null differ diff --git a/mentoring/programs/contributor-workshop/resources/guides/presenterviewandslides.png b/mentoring/programs/contributor-workshop/resources/guides/presenterviewandslides.png deleted file mode 100644 index f3e88d60..00000000 Binary files a/mentoring/programs/contributor-workshop/resources/guides/presenterviewandslides.png and /dev/null differ diff --git a/mentoring/programs/contributor-workshop/resources/guides/presenterwindowed.png b/mentoring/programs/contributor-workshop/resources/guides/presenterwindowed.png deleted file mode 100644 index 653d76ce..00000000 Binary files a/mentoring/programs/contributor-workshop/resources/guides/presenterwindowed.png and /dev/null differ diff --git a/mentoring/programs/contributor-workshop/resources/guides/slidesnotabs.png b/mentoring/programs/contributor-workshop/resources/guides/slidesnotabs.png deleted file mode 100644 index 1b41c84b..00000000 Binary files a/mentoring/programs/contributor-workshop/resources/guides/slidesnotabs.png and /dev/null differ diff --git a/mentoring/programs/contributor-workshop/resources/guides/slideswithtabs.png b/mentoring/programs/contributor-workshop/resources/guides/slideswithtabs.png deleted file mode 100644 index e82882a2..00000000 Binary files a/mentoring/programs/contributor-workshop/resources/guides/slideswithtabs.png and /dev/null differ diff --git a/mentoring/programs/contributor-workshop/resources/guides/updating-segment.md b/mentoring/programs/contributor-workshop/resources/guides/updating-segment.md deleted file mode 100644 index 7f9aba1c..00000000 --- a/mentoring/programs/contributor-workshop/resources/guides/updating-segment.md +++ /dev/null @@ -1,57 +0,0 @@ -# Updating workshop segments - -This guide covers how to update segments in the Contributor Workshop. - -- [Updating workshop segments](#updating-workshop-segments) - - [Prerequisites](#prerequisites) - - [Fork & Clone the ``contributor-site``](#fork--clone-the-contributor-site) - - [Checkout a branch off the workshop branch for your changes](#checkout-a-branch-off-the-workshop-branch-for-your-changes) - - [Run the site locally with your changes](#run-the-site-locally-with-your-changes) - - [Modifying an existing segment](#modifying-an-existing-segment) - - [Adding a segment to the workshop](#adding-a-segment-to-the-workshop) - - [Adding a video guide to accompany a segment](#adding-a-video-guide-to-accompany-a-segment) - - [Save, Commit, Push, PR](#save-commit-push-pr) - -## Prerequisites - -### Fork & Clone the ``contributor-site`` - -Create a fork of the [``contributor-site``](https://github.com/kubernetes/contributor-site/tree/workshop) repo. - -Clone your fork locally - -### Checkout a branch off the workshop branch for your changes - -```bash -git checkout workshop - -git checkout -b my-changes -``` - -### Run the site locally with your changes - -Follow the instructions in the top level [``README.md``](https://github.com/kubernetes/contributor-site/tree/master/README.md#running-the-site-locally) on the contributor-site. - -You're now ready to update and add segments! - -## Modifying an existing segment - -Find the file you would like to edit and open it. See [the list of segments](https://github.com/kubernetes/contributor-site/tree/workshop/content/en/workshop/CONTRIBUTING.md#list-of-segments). - -## Adding a segment to the workshop - -Make sure to update [the list of segments](https://github.com/kubernetes/contributor-site/tree/workshop/content/en/workshop/CONTRIBUTING.md#list-of-segments), with the new page. - -If inserting a page between existing pages, make sure to update the page weightings in the frontmatter and [the list of segments](https://github.com/kubernetes/contributor-site/tree/workshop/content/en/workshop/CONTRIBUTING.md#list-of-segments),. - -See [the segment template](../templates/segment-template.md), on how to structure your segment. - -## Adding a video guide to accompany a segment - -With some of the guides, we might want a youtube video to accompany them. You can find the information for adding a video to the guide, in the [video guide](videoguide.md) - -## Save, Commit, Push, PR - -Once you've made the modifications and additions you want, commit and push them to your fork. - -Then make a pull request of your changes into the ``workshop`` branch of the ``contributor-site`` repo. \ No newline at end of file diff --git a/mentoring/programs/contributor-workshop/resources/guides/videoguide.md b/mentoring/programs/contributor-workshop/resources/guides/videoguide.md deleted file mode 100644 index 13094925..00000000 --- a/mentoring/programs/contributor-workshop/resources/guides/videoguide.md +++ /dev/null @@ -1,293 +0,0 @@ - -# Video Recording Guide for Contributor Workshop Segments - -This guide covers, how to structure, record, upload and update video guides associated with workshop segments. - -- [Format / Video Style](#format--video-style) -- [Encoding Guidelines](#encoding-guidelines) - - [Zoom Recording](#zoom-recording) - - [OBS](#obs) - - [Streamyard](#streamyard) - - [Adobe Media Encoder](#adobe-media-encoder) -- [Recording Guides](#recording-guides) - - [Record Using Zoom](#record-using-zoom) - - [Install Windowed extension (optional)](#install-windowed-extension-optional) - - [Start the meeting](#start-the-meeting) - - [Setting up slides for recording](#setting-up-slides-for-recording) - - [Without browser extension](#without-browser-extension) - - [With browser extension](#with-browser-extension) - - [Note : Exiting the windowed mode](#note--exiting-the-windowed-mode) - - [Adding your facecam](#adding-your-facecam) - - [Unmute your audio](#unmute-your-audio) - - [Recording in Zoom](#recording-in-zoom) - - [Note : Do a test recording first](#note--do-a-test-recording-first) - - [How to record](#how-to-record) - - [Recording in OBS](#recording-in-obs) - - [Recording in Streamyard](#recording-in-streamyard) -- [Updating / Adding video to a segment](#updating--adding-video-to-a-segment) - - [Rename your recording](#rename-your-recording) - - [Upload your video to Google Drive](#upload-your-video-to-google-drive) - - [Updating Youtube](#updating-youtube) -- [Update the Segment page with video](#update-the-segment-page-with-video) -- [Best Practices & Recommendations](#best-practices--recommendations) - - [Video](#video) - - [Camera Type](#camera-type) - - [Audio](#audio) - - [Microphone Types](#microphone-types) - - [Sound Environment](#sound-environment) - - [Background Noise](#background-noise) - - [Removing Background noise in Zoom](#removing-background-noise-in-zoom) - - [Removing Background noise with Krisp](#removing-background-noise-with-krisp) - - [Removing Background noise with NVIDIA Broadcast or RTX Voice](#removing-background-noise-with-nvidia-broadcast-or-rtx-voice) - - [Other Tips](#other-tips) - - [Screensharing](#screensharing) - - [Hardware](#hardware) - - [Headset Microphones](#headset-microphones) - - [External Microphones](#external-microphones) - - [Webcams](#webcams) - - [Presentation remotes](#presentation-remotes) - -## Format / Video Style - -You can use any format/style as long as the same information in the guide is captured in the video. Slides, A screenshare, green screen yourself into the repo even! Be creative. - -## Encoding Guidelines - -### Zoom Recording - -Handled by zoom, Can't change these settings. - -### OBS - -![OBS Settings](obssettings.png) - -### Streamyard - -Handled by Streamyard, Can't change these settings. - -### Adobe Media Encoder - -use Youtube 1080p Full HD - -## Recording Guides - -Guides on how to record a presentation style video (slides/screen,facecam) - -### Record Using Zoom - -#### Install Windowed extension (optional) - -This makes it easier for you to share the slides to zoom. Allows you to pop out the fullscreen view to a single window. - -[GitHub Link](https://github.com/dralletje/Windowed) - -#### Start the meeting - -Start a meeting in zoom (you can start and record a meeting with a single participant) - -#### Setting up slides for recording - -Open your slides in Presenter View - -![Presenter View](presenterview.png) - -It should open a presenter view, with a timer, slide notes, and change the tab from editor to a slideshow presentation - -![Presenter View and Slides](presenterviewandslides.png) - -You will use the presenter view to control the slides, and the slide view will be cast to the zoom call. - -##### Without browser extension - -Share the window which is displaying the slides view. - -![Slides with your tabs](slideswithtabs.png) - -##### With browser extension - -When moving your mouse on the slide view a small dialog with the slide number, and triple dots will appear. Select the triple dots and enter full screen - -![Enter Full Screen on Presentation](presenterfullscreen.png) - -After selecting the fullscreen option, you will be presented further options on how to display the slides. - -Select the windowed option - -![Windowed Fullscreen](presenterwindowed.png) - -A new window with only the slides will appear, Share this window in zoom. - -![Slides with no tabs](slidesnotabs.png) - -###### Note : Exiting the windowed mode - -To exit out of this view, and go back the editor, select the window with the slide view back into focus, move your mouse until the triple dots mentioned earlier appear. Select the triple dots again and ``Exit Full Screen`` - -![Exit Full Screen](presenterexitfullscreen.png) - -#### Adding your facecam - -If you haven't done so already, start your video in Zoom. - -#### Unmute your audio - -If you haven't done so already, unmute your audio in Zoom. - -#### Recording in Zoom - -Now that you've got your slides, video and audio setup, you're ready to record! - -##### Note : Do a test recording first - -It's good practice to create a test recording of your whole setup in action. -If you change shares between windows, check that changing the shares appears how you want it to in the video. - -##### How to record - -Select the ``Record`` button in zoom. - -If you have the option between saving locally, and in the cloud, select locally. - -Once you have finished recording, end the meeting. - -A popup should appear with progress on converting the recording. -Once the recording is converted, a file browser window with the recording will be opened. Rename the recording from ``zoom_0.mp4`` to the format described in [Rename your recording](#rename-your-recording) - -### Recording in OBS - -Coming soon - -### Recording in Streamyard - -Coming soon - -## Updating / Adding video to a segment - -### Rename your recording - -Rename your recording to ``YYYY-MM-DD--.mp4`` - -Where - -- ``YYYY-MM-DD`` being date, is the date video was recorded -- ```` being the name of the markdown file associated with that segment. see [CONTRIBUTING.md](https://github.com/kubernetes/contributor-site/tree/workshop/content/en/workshop/CONTRIBUTING.md#list-of-segments) -- ```` being the github handle of the person who recorded the video, if there are multiple presenters just add another dash and the handle. ``-`` - -For example - -``2021-05-10-why-contribute-alisondy.mp4`` - -``2021-05-10-why-contribute-alisondy-mrbobbytables.mp4`` - -### Upload your video to Google Drive - -Upload your recording to the Google Drive folder provided for the Workshop Videos. - -### Updating Youtube - -Once you have uploaded the video to drive, contact one of the [youtube admins](/communication/moderators.md#youtube-channel) to upload it to the Kubernetes YouTube channel. - -> Youtube Admins see [Video Upload Guide](videouploadguide.md) for details about uploading the segment to youtube - -## Update the Segment page with video - -If adding to a segment page where video doesn't exist, Paste this at the top, after the frontmatter. Fill in the details with the youtube id of the video you just uploaded. - -If adding to a segment page where a video already exists, update the youtube id in the shortcode, with the video id of your newly uploaded video. - -```txt -## Video Walkthrough - -{{< youtube id="" title="Contributor Workshop : }} -``` - -## Best Practices & Recommendations - -### Video - -#### Camera Type - -Use an external camera or webcam to capture your video. - -Built in webcams restrict the angle of you webcam, to the viewing angle of your display, and often provide a low quality image. - -- Use an external webcam. 1080p preferred or 720p at a minimum. Typically, either will be better quality than the built-in camera on your laptop. -- Lighting - Adjusting your lighting may help you get a better camera feed in less than optimal lighting conditions. - - Optimize the ambient lighting within your space first. - - There should be no window or strong light source behind you that darkens your face - - There should be no strong light source from one side that casts a shadow on the opposite side of your face. - - Good ambient lighting from your ceiling lights or windows may be enough as long as they are in front of you. - - Diffused lighting is better than harsh, direct lighting. -- Background – keep it clean and uncluttered. It’s great to show off your personality/style in your home, just be sure to keep everything appropriate for a general audience and compliant with the Code of Conduct. A plain wall is also just fine, no need to overdo it. -- Camera Position - as close as possible at your eye level, not pointing up towards your nose or the ceiling, or down towards the floor. It can be as simple as raising your laptop via a few books. Or if you have an external webcam, position it on the top edge or close to the top of the screen from which you are advancing your slides/notes. -- Keep eye contact with the camera just like you would look at your audience during an in-person presentation. It's okay to look away for brief moments, just make sure you look towards the camera for the majority of the presentation. -- Video with more lighting tips [https://youtu.be/rGcAM1CNEU0](https://youtu.be/rGcAM1CNEU0) - -### Audio - -#### Microphone Types - -**Best:** External microphone (condenser recommended over dynamic*) via a USB connection or DAC. This type of microphone will pick up audio from a distance as well as up close really well. This means you can position it a fair distance away from yourself when recording. If using one of these microphones, try to position it out of frame from your video. - -**Good:** Headset Microphone, this could be a microphone located on the wires like on mobile earphones, the mic on your wireless earphones as well as the usual fold down microphone on a headset. All of these assist with isolating microphone pick-up from ambient noises within your recording/streaming space. Wired headsets will give you better quality audio than wireless. - -**Acceptable:** External microphone built into your webcam. Often better quality than your built-in laptop microphone. - -**Worst:** Your built-in laptop microphone. These are generally low-quality microphones, and they have little or no ability to filter out background noise. - -#### Sound Environment - -##### Background Noise - -It’s best to be in a controlled environment with little to no background noise. -If this is not possible you can use your recording software and other software to remove background noise. -Another option to filtering out background noise or being in a controlled environment is using push to talk, or unmuting your mic whenever you need to speak. - -###### Removing Background noise in Zoom - -In zoom settings under ``Audio`` -Change the Suppress background noise setting to ``High`` - -###### Removing Background noise with Krisp - -Krisp provides AI powered background noise cancellation, see [krisp.ai](https://krisp.ai/) for more information. - -###### Removing Background noise with NVIDIA Broadcast or RTX Voice - -If you're using Windows, and are using certain models of NVIDIA GPU, you can install either NVIDIA Broadcast or RTX Voice to filter out background noise. See [RTX Voice setup guide](https://www.nvidia.com/en-us/geforce/guides/nvidia-rtx-voice-setup-guide/) and [Broadcast app setup guide](https://www.nvidia.com/en-gb/geforce/guides/broadcast-app-setup-guide/) for more information. - -##### Other Tips - -- Mute all notifications and programs not being recorded -- Disable any unnecessary audio devices - -### Screensharing - -- Increase the font size when sharing terminals, text editors -- Ensure you have all the windows you need opened before recording. -- Export any sensitive variables needed in your terminals before starting your presentation -- If using a passworded ssh key, Start a ssh-agent in the terminal beforehand. - -### Hardware - -Here are some equipment recommendations from the CNCF: - -#### Headset Microphones - -Logitech / Plantronics – i.e. Logitech H111 / Logitech H390 / Plantronics C225 - -#### External Microphones - -Blue / Samson – i.e. Blue Snowball / Blue Yeti / Samson Meteor / Samson G-Track - -#### Webcams - -Good value – Logitech C920 - -More info – [https://www.tomsguide.com/news/where-to-buy-webcams-now-these-retailers-have-stock](https://www.tomsguide.com/news/where-to-buy-webcams-now-these-retailers-have-stock) - -#### Presentation remotes - -Logitech / Canon / Kensington / SMK - -Tested and recommended for PC or Mac – Logitech R400, R800, Spotlight / Canon PR500, PR100 diff --git a/mentoring/programs/contributor-workshop/resources/guides/videouploadguide.md b/mentoring/programs/contributor-workshop/resources/guides/videouploadguide.md deleted file mode 100644 index 147bb070..00000000 --- a/mentoring/programs/contributor-workshop/resources/guides/videouploadguide.md +++ /dev/null @@ -1,97 +0,0 @@ -# Segment Upload Guide for Youtube Admins - -## Upload the new video - -In youtube, upload the same video and title it as follows - -```txt -Contributor Workshop : with | -``` - -For example - -```txt -Contributor Workshop : Why Contribute? with @alisondy | May 2021 -``` - -## Adding the thumbnail image - -```markdown -TODO : Instructions on how to generate a thumbnail image, similar to https://gist.github.com/alisondy/e4ff3b483a32330ade0c880b4a4a10b1 -``` - -Set the thumbnail to the image generated in the previous step - -## Setting the description - -Use the following template for setting the video description - -```txt -This is the video guide for the Contributor Workshop segment - -Link to this segments page: -https://kubernetes.dev/docs/workshop/ - -Link to the workshop: -https://kubernetes.dev/docs/workshop/ -``` - -## Update the previous video for the segment if it exists - -If you're updating an already existing video, follow the next steps to update the following on the previous video - -- title -- thumbnail -- description -- comments section - -## Update the title - -Update the title on the previous video to match the following format - -```txt -Contributor Workshop : | | 🚨🚨 DEPRECATED 🚨🚨 -``` - -For example - -```txt -Contributor Workshop : Why Contribute? with @alisondy | May 2021 | 🚨🚨 DEPRECATED 🚨🚨 -``` - -## Update the thumbnail image - -Update the Thumbnail image on the previous video to - -insert-deprecation-thumbnail-here.jpeg - -```txt - - -THIS VIDEO IS DEPRECATED! -See the comments & description for details on where to find the new video guide! - - -``` - -## Update the Description - -On the previous video, add the following to the start of the description - -```txt -🚨🚨 DEPRECATED , Please see 🚨🚨 -``` - -## Update the Comments - -On the previous video, add the following as a comment as Kubernetes YT & pin to the top of the comments - -```txt -🚨🚨 DEPRECATED , Please see 🚨🚨 -``` - -Close the comment section of the deprecated video - -## Update the Playlist - -Update the youtube playlist with the segment recording. Remove the previous version of the video from the playlist if it exists. diff --git a/mentoring/programs/contributor-workshop/resources/live-workshop/README.md b/mentoring/programs/contributor-workshop/resources/live-workshop/README.md deleted file mode 100644 index 3958d322..00000000 --- a/mentoring/programs/contributor-workshop/resources/live-workshop/README.md +++ /dev/null @@ -1,39 +0,0 @@ -# Live Workshops Resources - -## Overview - -This folder contains the [handbook for the New Contributor Workshop Content Lead](./new-contributor-workshop-lead.md) as well as playbooks for each of the Contributor Workshop sessions in a live setting. - -This workshop is held periodically by the Kubernetes Community, but materials and processes may be used at contributor focused summits and events anywhere. - -Slides from previous New Contributor Workshops can be found [here](https://github.com/cncf/presentations/blob/master/kubernetes/README.md#kubernetes-new-contributor-workshops). - -## Sample Track for Beginner Workshop - -This workshop is meant for folks who have never contributed to opensource before and/or need help setting up a Kubernetes developer environment. - -1. Welcome -1. [Live PR Demo](./live-pr-demo.md) -1. [Paths to Contributorship](./contributor-paths.md) -1. [Communication in the Kubernetes Community](./how-we-communicate.md) -1. [Community Group and Governance Overview](./community-groups.md) -1. [Kubernetes Orgs Overview](./repo-tour.md) -1. [Workspace Setup](./workspace-setup.md) -1. [Local Build&Test](./build-and-test.md) -1. [Pull Request Exercise](./playground-exercise.md) -1. [Find Your First Issue](./first-issue-help.md) - -## Sample Track for Intermediate Workshop - -This workshop differs from the Beginner workshop in that participants are expected to have a working Docker/Kubernetes/Go setup. They have a basic understanding of how opensource contributions work, and may have opened a PR against Kubernetes before. - -1. Welcome -1. [Live PR Demo](./live-pr-demo.md) -1. [Paths to Contributorship](./contributor-paths.md) -1. [Communication in the Kubernetes Community](./how-we-communicate.md) -1. [Community Group and Governance Overview](./community-groups.md) -1. [Kubernetes Orgs Overview](./repo-tour.md) -1. k/k Walkthrough -1. [Local Build&Test](./build-and-test.md) -1. [Labels, Bots and Git Workflow](./labels-and-bots.md) -1. [Find Your First Issue](./first-issue-help.md) diff --git a/mentoring/programs/contributor-workshop/resources/live-workshop/build-and-test.md b/mentoring/programs/contributor-workshop/resources/live-workshop/build-and-test.md deleted file mode 100644 index 147d91a3..00000000 --- a/mentoring/programs/contributor-workshop/resources/live-workshop/build-and-test.md +++ /dev/null @@ -1,27 +0,0 @@ -## Build and Test - -### Duration - -40-60 minutes, depending on beginner vs intermediate participants - -### Task Overview - -Build Kubernetes binaries locally, and do some fun things with them. - -**Important** Have facilitators to help with technical issues (2-3 is enough for Intermediate, you want 5 for Beginner) - -### Slides - -Clear command line instructions. - -### Details To Cover - -- This is the hands-on part. Details are up to you; look to previous workshops for inspiration. -- Adjust difficulty based on whether this is the Beginner or Intermediate workshop. -- It is _extremely important_ to run this part of the workshop several times previously, and to make sure that versions match those in the [workspace setup](./workspace-setup.md). - -### Ideas - -- Do a fun thing with the Kubernetes [go client](https://git.k8s.io/client-go) and a [kind](https://sigs.k8s.io/kind) cluster. -- Build and modify `kubectl`. -- Try a `make` command; be aware you may need to give docker a lot of space on your machine for a successful build. diff --git a/mentoring/programs/contributor-workshop/resources/live-workshop/community-groups.md b/mentoring/programs/contributor-workshop/resources/live-workshop/community-groups.md deleted file mode 100644 index 01a8c80c..00000000 --- a/mentoring/programs/contributor-workshop/resources/live-workshop/community-groups.md +++ /dev/null @@ -1,27 +0,0 @@ -## Community Groups - -### Duration - -15 minutes - -### Task Overview - -Introduce SIGs, Working Groups, and a tiny bit of governance (if you must). - -### Slides - -Refer to previous workshops for inspirations. - -### Details To Cover - -- SIGs -- Subprojects -- Working Groups -- User Groups -- Committees -- How to Join Any Of The Above - -### Ideas - -- Stay simple. Don't make it too complicated. -- Ask participants to define a few example SIGs via audience interaction. \ No newline at end of file diff --git a/mentoring/programs/contributor-workshop/resources/live-workshop/contributor-paths.md b/mentoring/programs/contributor-workshop/resources/live-workshop/contributor-paths.md deleted file mode 100644 index d14691eb..00000000 --- a/mentoring/programs/contributor-workshop/resources/live-workshop/contributor-paths.md +++ /dev/null @@ -1,26 +0,0 @@ -## Contributor Paths - -### Duration - -10-30 minutes - -### Task Overview - -This is about contributor origin stories. - -### Slides - -Refer to previous workshops for inspirations - -### Details To Cover - -- Who can contribute? -- What skills are needed? -- How to Fit Contributions Into Your Job -- Balance knowledge with learning and the needs of the project - -### Ideas - -- Share some contributor origin stories -- Ask the room why they are at the workshop -- Have a few people share their thoughts diff --git a/mentoring/programs/contributor-workshop/resources/live-workshop/first-issue-help.md b/mentoring/programs/contributor-workshop/resources/live-workshop/first-issue-help.md deleted file mode 100644 index b99488af..00000000 --- a/mentoring/programs/contributor-workshop/resources/live-workshop/first-issue-help.md +++ /dev/null @@ -1,31 +0,0 @@ -## Finding Your First Issue - -### Duration - -20 minutes - -### Task Overview - -Set participants on as much of a paved path to contributor success as possible. -At this point in the workshop, participants should know what kind of issue they want to tackle. - -### Slides - -Refer to previous workshops for inspirations - -### Details To Cover - -- help-wanted and good-first-issue labels -- Up and coming sandbox projects -- Working with your SIG -- Refer participants to specific SIGs -- How to "claim" an issue (since non-members cannot self-assign) -- Path to [membership](/community-membership.md) - -### Ideas - -- Give folks time to discuss and help each other -- Gather information from SIGs in advance (via Slack, Twitter...) on who needs help, and at what level -- Prepare a list of issues and assign folks right there -- Connect participants to mentoring tracks if available (e.g. Release Team Shadow) - diff --git a/mentoring/programs/contributor-workshop/resources/live-workshop/how-we-communicate.md b/mentoring/programs/contributor-workshop/resources/live-workshop/how-we-communicate.md deleted file mode 100644 index 777929e2..00000000 --- a/mentoring/programs/contributor-workshop/resources/live-workshop/how-we-communicate.md +++ /dev/null @@ -1,33 +0,0 @@ -## How We Communicate - -### Duration - -10-30 minutes - -### Task Overview - -Show how we communicate in the community, and which tools are for what purpose. - -### Slides - -Refer to previous workshops for inspirations. - -### Details To Cover - -- [Code of Conduct](https://git.k8s.io/community/code-of-conduct.md) (CoC) -- Where We Talk: - - Slack - - Discuss -- How We Decide: - - GitHub - - Zoom - - Mailing List -- Calendar -- Meetups - -### Ideas - -- Have a #ncw channel on Slack. The first person who finds the Slack channel with the most members, or the longest name(etc) and posts in here wins a prize! -- Everyone introduces their neighbor and a cool Kubernetes fact about them in a Slack or Discuss channel/topic. -- Put an easter egg in the mailing list and whoever discovers it first by joining and reading the discussions, wins a prize! -- Come up with the most creative TL;DR for the CoC. \ No newline at end of file diff --git a/mentoring/programs/contributor-workshop/resources/live-workshop/labels-and-bots.md b/mentoring/programs/contributor-workshop/resources/live-workshop/labels-and-bots.md deleted file mode 100644 index 0e191f03..00000000 --- a/mentoring/programs/contributor-workshop/resources/live-workshop/labels-and-bots.md +++ /dev/null @@ -1,25 +0,0 @@ -## Labels and Bots - -### Duration - -10 - 15 minutes - -### Task Overview - -Show the Kubernetes automation and PR workflow, as well as the bot command help page. -This task is meant as a short overview for Intermediate content. - -### Slides - -The [PR workflow diagram](https://git.k8s.io/community/blob/master/contributors/guide/git_workflow.png) is useful here. There are also previous slides that explain the differnet labels. - -### Details To Cover - -- Which labels are used how, and by whom? -- How to add labels -- Other bot commands -- Prow - -### Ideas - -- Play with bots in the [contributor playground](https://sigs.k8s.io/contributor-playground) diff --git a/mentoring/programs/contributor-workshop/resources/live-workshop/live-pr-demo.md b/mentoring/programs/contributor-workshop/resources/live-workshop/live-pr-demo.md deleted file mode 100644 index 27b6c97e..00000000 --- a/mentoring/programs/contributor-workshop/resources/live-workshop/live-pr-demo.md +++ /dev/null @@ -1,24 +0,0 @@ -## Live PR Demo - -### Duration - -Plan for about 30 minutes - -### Task Overview - -Demonstrate opening a pull request against the [Kubernetes/Kubernetes](https://git.k8s.io/kubernetes) (k/k) repository. There are some docs cleanup good-first-issues, but feel free to show off something you've been working on for a while. - -### Slides - -None; this is a live demo. - -### Details To Cover - -- Make sure to prepare code in advance but only commit locally -- Show the k/k pull request workflow -- Show the PR templates and fill them out, explaining why -- Interact with the bot and briefly mention labels/OWNERS files -- Leave room for questions, but be aware that the workflow will be covered in depth later. - -### Ideas -- ask the audience or a pre-planned reviewer for code review, showing more of the k/k automation diff --git a/mentoring/programs/contributor-workshop/resources/live-workshop/new-contributor-workshop-lead.md b/mentoring/programs/contributor-workshop/resources/live-workshop/new-contributor-workshop-lead.md deleted file mode 100644 index b6398d28..00000000 --- a/mentoring/programs/contributor-workshop/resources/live-workshop/new-contributor-workshop-lead.md +++ /dev/null @@ -1,54 +0,0 @@ -# New Contributor Workshop Lead - -## Overview -The New Contributor Workshop Lead is in charge of planning and executing the New Contributor Workshop. They will coordinate with the overall Events Team and the organizers of related activities aimed at new contributors. - -## Skills and Qualifications - -The New Contributor Content Lead must be a current, active Kubernetes contributor who is knowledgeable of the community and organizational structure of the Kubernetes project, as well as familiar with building and developing Kubernetes. -They should have experience and be comfortable with teaching in a workshop setting and presenting interactively in front of an audience. -Additionally, they must be able to relate to and empathize with newcomers of many different experience levels. -As this role is part of a subproject of SIG-contributor-experience, the New Contributor Content Lead must be a member of SIG-contributor-experience. - -## Activities - -*These tasks reflect a rough timeline leading from the end of the previous New Contributor Workshop to the currently planned one.* -- Attend event planning meetings in preparation for the New Contributor Workshop, where applicable. -- Create a Workshop Content Proposal and link in an Issue to k/community: - - determine sessions and their overall topic (e.g. How We Communicate, Code Base Walkthrough, etc) - - determine what difficulty/experience levels will be offered, if any, and coordinate with Lead - - determine workshop capacity, and coordinate with Lead - - determine room requirements (size, number, table/chair layout, A/V) and coordinate with the planning team -- Coordinate with New Contributor Content Shadows to prepare them for leading this role. -- Recruit and coordinate with workshop teachers for any sessions/topics you do not wish to teach yourself (e.g. invite someone to speak on "Communication in the Kubernetes Project"). -- Make modifications and continuous improvements to the new contributor workshop template. -Incorporate feedback from previous New Contributor Workshops. -Shadows and co-presenters are expected to assist and review these updates. -[Past presentations are linked here](https://github.com/cncf/presentations/tree/master/kubernetes) - please make a copy of the existing deck before updating/editing. -- Work with Registration to: - - disseminate course materials (slides) in advance - - ensure participants sign the CLA - - ensure attendees meet technical and experience requirements for their course - - obtain a comprehensive list of names, emails, and GitHub handles -- Ensure to advertise the SIG-Intros. -- Solicit feedback from workshop participants. - -## Time Commitment - -1-2 hours/week most of the time, 4-5 in the weeks leading up to NCW, depending on previous teaching/shadowing experience. - -## Coupon Codes - -If you would like to share coupon codes for the CNCF store with your -attendees, please create an issue in the [kubernetes/funding] repo and -assign [SIG Contributor Experience chairs] for approval. - -The funding request should contain the following details: -- Number of coupon codes required -- Desired amount of each coupon code (e.g. $20) OR desired swags for each coupon code (e.g. 1 Tshirt, 2 stickers) - -Once the request is approved, the chairs will create a CNCF Service Desk -ticket to get the list of coupon codes. - -[kubernetes/funding]: https://github.com/kubernetes/funding -[SIG Contributor Experience chairs]: /sig-contributor-experience#chairs diff --git a/mentoring/programs/contributor-workshop/resources/live-workshop/playground-exercise.md b/mentoring/programs/contributor-workshop/resources/live-workshop/playground-exercise.md deleted file mode 100644 index 6aca9178..00000000 --- a/mentoring/programs/contributor-workshop/resources/live-workshop/playground-exercise.md +++ /dev/null @@ -1,28 +0,0 @@ -## Playground Exercise - -### Duration - -30 - 50 minutes - -### Task Overview - -Give new contributors the experience of the Kubernetes GitHub workflow! -This task requires some setup and planning. - -Create a New Contributor Workshop folder specific to this event, with teachers' and participants' GitHub handles in the OWNERS file. -[Here is an example](https://sigs.k8s.io/contributor-playground/seattle). Make sure to obtain participants' GitHub handles from the event registrar in advance. -Issue and PR exercise ideas can be found [here](https://sigs.k8s.io/contributor-playground/exercises). - -### Slides - -Refer to previous workshops for inspirations. - -### Details To Cover - -- Labels and bot commands - more material [here](./labels-and-bots.md) -- Automation -- How to assign reviewers - -### Ideas - -- The first person to `/honk` on a PR wins a prize! diff --git a/mentoring/programs/contributor-workshop/resources/live-workshop/repo-tour.md b/mentoring/programs/contributor-workshop/resources/live-workshop/repo-tour.md deleted file mode 100644 index d1f46ee0..00000000 --- a/mentoring/programs/contributor-workshop/resources/live-workshop/repo-tour.md +++ /dev/null @@ -1,24 +0,0 @@ -## Repo Tour - -### Duration - -10 - 15 minutes - -### Task Overview - -Show that Kubernetes is not just about the Core Repository, but also about the other repos in the org and in kubernetes-sigs. - -### Slides - -Have a few overview slides, but also go off-book and live show the repos on GitHub. - -### Details To Cover - -- k/website, k/test-infra, k/community, k/enhancements, with explanations -- Exciting things in kubernetes-sigs - - -### Ideas - -- Ask participants if they have found or are interested in specific repos, and share about their purpose. -- Mention which repos need help, or have awesome good-first-issue shepherding from maintainers! \ No newline at end of file diff --git a/mentoring/programs/contributor-workshop/resources/live-workshop/workspace-setup.md b/mentoring/programs/contributor-workshop/resources/live-workshop/workspace-setup.md deleted file mode 100644 index 19dbef29..00000000 --- a/mentoring/programs/contributor-workshop/resources/live-workshop/workspace-setup.md +++ /dev/null @@ -1,24 +0,0 @@ -## Workspace Setup - -### Duration - -Plan for 90- 120 minutes of download and setup time when on wifi. When on a workshop specific network, this may be much shortened. - -### Task Overview - -Make sure all Beginning Contributors have a workspace setup for hacking on Kubernetes. - -**Important** Have facilitators to help with technical issues (3-5 for ~30 people) - -### Slides - -Clear and large download commands to copy into the terminal. - -### Details To Cover - -- Make sure everyone has the correct setup for a local build and test demo. - -### Ideas - -- Have a dedicated workshop network. -- When internet is slow, start the download and prep process during earlier sessions, to make sure everyone is up to date. diff --git a/mentoring/programs/contributor-workshop/resources/templates/segment-template.md b/mentoring/programs/contributor-workshop/resources/templates/segment-template.md deleted file mode 100644 index dc413799..00000000 --- a/mentoring/programs/contributor-workshop/resources/templates/segment-template.md +++ /dev/null @@ -1,33 +0,0 @@ ---- -title: "Segment Name" # The name of the page -weight: 2 # Ordering of the page -description: | - A brief description of what this segment aims to cover. ---- - -## Goals - - -By the end of this segment you should be able to: -* Identify areas of Kubernetes you would like to contribute to -* Understand the differences between Special Interest Groups, Working Groups and Subprojects - -## Subsection Heading - - - -## Another Subsection Heading - - - -## Exercise : Name Of Exercise - - - -### Name Of First Step - - - -### Name Of Second Step - - diff --git a/mentoring/programs/contributor-workshop/templates/segment-template.md b/mentoring/programs/contributor-workshop/templates/segment-template.md new file mode 100644 index 00000000..dc413799 --- /dev/null +++ b/mentoring/programs/contributor-workshop/templates/segment-template.md @@ -0,0 +1,33 @@ +--- +title: "Segment Name" # The name of the page +weight: 2 # Ordering of the page +description: | + A brief description of what this segment aims to cover. +--- + +## Goals + + +By the end of this segment you should be able to: +* Identify areas of Kubernetes you would like to contribute to +* Understand the differences between Special Interest Groups, Working Groups and Subprojects + +## Subsection Heading + + + +## Another Subsection Heading + + + +## Exercise : Name Of Exercise + + + +### Name Of First Step + + + +### Name Of Second Step + + -- cgit v1.2.3 From d06f5ee564588c39dbb6b515e1afe5006591a001 Mon Sep 17 00:00:00 2001 From: Alison Dowdney Date: Wed, 23 Jun 2021 13:08:36 +0100 Subject: update segment guide --- .../programs/contributor-workshop/guides/updating-segment.md | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) (limited to 'mentoring/programs') diff --git a/mentoring/programs/contributor-workshop/guides/updating-segment.md b/mentoring/programs/contributor-workshop/guides/updating-segment.md index 1b4f3e37..f3acafd1 100644 --- a/mentoring/programs/contributor-workshop/guides/updating-segment.md +++ b/mentoring/programs/contributor-workshop/guides/updating-segment.md @@ -16,16 +16,19 @@ This guide covers how to update segments in the Contributor Workshop. ### Fork & Clone the ``contributor-site`` -Create a fork of the [``contributor-site``](https://github.com/kubernetes/contributor-site/tree/workshop) repo. +Create a fork of the [``contributor-site``](https://github.com/kubernetes/contributor-site) repo. Clone your fork locally ### Checkout a branch off the workshop branch for your changes ```bash +git remote add upstream git@github.com:kubernetes/contributor-site.git +git remote set-url --push upstream no_push +git fetch upstream git checkout workshop - -git checkout -b my-changes +git rebase upstream/workshop +git checkout ``` ### Run the site locally with your changes -- cgit v1.2.3