Skip to content

Commit 0f18fb4

Browse files
k8s-ci-robotk8s-ci-robot
authored
Merge pull request #4748 from alisondy/update-ncw
Update NCW Resources, Files
2 parents 912dfd3 + 22377d2 commit 0f18fb4

16 files changed

+377
-38
lines changed

‎mentoring/programs/new-contributor-workshop/2020/03-contributor-summit/README.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
## NCW Workshop Amsterdam
2+
3+
## Team
4+
5+
| Name & Handle | Role | Timezone |
6+
|---------------|------|----------|
7+
| | | |
8+
| | | |
9+
| | | |
10+
11+
## Deadlines
12+
13+
## Meeting Information

‎mentoring/programs/new-contributor-workshop/2020/03-contributor-summit/content-proposal.md

Lines changed: 165 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,165 @@
1+
# Content Proposal for NCW Amsterdam
2+
3+
## Introduction
4+
5+
### 9:30 - 11:00 Intro Communications and Community
6+
Alison, Rob, Rael, Josh: support/segment?
7+
8+
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.
9+
10+
Note: Although these will have to be run separately, the content will be the same.
11+
12+
## NCW Topics 101
13+
14+
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.
15+
16+
### Morning Session
17+
18+
#### 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
19+
20+
Make sure all Beginning Contributors have a workspace setup for hacking on Kubernetes
21+
22+
#### 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
23+
#### 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
24+
25+
Build Kubernetes binaries locally, and do some fun things with them.
26+
27+
### Afternoon Sessions
28+
29+
#### 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
30+
31+
Give new contributors the experience of the Kubernetes GitHub workflow!
32+
33+
This task requires some setup and planning. Labels, Bots
34+
35+
#### 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
36+
37+
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.
38+
39+
## NCW Topics 201
40+
41+
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.
42+
43+
### Morning Session
44+
45+
#### 11:00 - 12:00 K/K Walkthrough Alison
46+
47+
Alison
48+
49+
Guided tour of the main k/k repository, to build a broader understanding of how the codebase is structured
50+
51+
#### 12:00 - 12:25 Labels, Bots and Git Workflow Guin & Rob
52+
53+
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.
54+
55+
### Afternoon Sessions
56+
57+
#### 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
58+
59+
Build Kubernetes binaries locally, and do some fun things with them.
60+
61+
#### 14:30 - 14:50 You! Yes you can review a PR! 15-20m Alison & Tim H
62+
63+
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.
64+
65+
#### 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
66+
67+
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.
68+
69+
## Resources To Create
70+
71+
* Capture who is presenting what
72+
73+
* Slides to reflect the content proposal
74+
75+
* Assign presenters for each section so presenters own their own slides
76+
77+
* Docker Image Registry
78+
79+
* Source Tree in a Docker Image incase of networking issues
80+
81+
* [Sheet of what will be on the Harbor box](https://docs.google.com/spreadsheets/d/1_CUFluzIgeHt4vra9hs6OqBqDZQ8oUl9Og-IixkoEAM/edit?usp=sharing)
82+
83+
* Add the needed container images, other binaries you want, and specific versions
84+
85+
* Know before you go details
86+
87+
* Instructions, What to install on your laptop, Sign the CLA
88+
89+
* Can we link and update the handbooks here? Every presenter can update the handbooks as content matures!
90+
91+
* On the day plan - More indepth dive of what happens
92+
93+
### On The Day / Extra Notes
94+
[runbook.md](runbook.md)
95+
96+
### Handbooks
97+
[../resources](../resources)
98+
99+
### Slides
100+
[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)
101+
102+
## Slide Ideas
103+
104+
* Solidify formatting for each type of slide
105+
106+
* Code with instructions
107+
108+
* Main Image
109+
110+
* Image with text
111+
112+
* Title Slides
113+
114+
* Schedule Slides
115+
116+
* 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
117+
118+
* From San Diego page
119+
*Try to represent the journey of a contributor with the slides*
120+
121+
* *Linking the key ideas themes, with walking along a brick road or similar. From cat to kubecat. *Or capybara to kubeybara
122+
123+
* Break Slides
124+
125+
* *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*
126+
127+
## References
128+
129+
San Diego Contributor Summit Content Proposal
130+
131+
[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)
132+
133+
Last years sched for san diego
134+
135+
[https://kcsna2019.sched.com/](https://kcsna2019.sched.com/)
136+
137+
Reference
138+
139+
[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)
140+
141+
## Virtual Event Go/No Go
142+
143+
Alison: Go (speaking live)
144+
145+
Jeff: Go (streaming/speaking live)
146+
147+
Josh: Go (pre-record; virtual Q&A)
148+
149+
Guin: Go (pre-record)
150+
151+
James M:
152+
153+
Rob: Go (Flexible; assign content ASAP)
154+
155+
Chris Short: Go (shadow; streaming)
156+
157+
Samudrala: Can present
158+
159+
Nabarun: Can present
160+
161+
Tim P: Can present (shadow)
162+
163+
Rael: No Go
164+
165+
Ben: No Go

‎mentoring/programs/new-contributor-workshop/2020/03-contributor-summit/runbook.md

Lines changed: 160 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,160 @@
1+
# NCW On The Day Runbook / Extra Notes
2+
3+
### 9:30 - 11:00 Intro Communications and Community
4+
Alison, Rob, Rael, Josh: support/segment?
5+
6+
Sections
7+
8+
* Welcome & PR Demo [Slide 6](https://docs.google.com/presentation/d/19OtCzuDTVeeIfMD39OOODGJzkV3UGM_nr7jpSNhoy2s/edit#slide=id.g64b51f6423_1_0)
9+
10+
* Why Contribute / Origin Story [Slide 10](https://docs.google.com/presentation/d/19OtCzuDTVeeIfMD39OOODGJzkV3UGM_nr7jpSNhoy2s/edit#slide=id.g5e6254b17b_4_1168)
11+
12+
* Why
13+
14+
* Origin Story
15+
16+
* Choose your adventure
17+
18+
* Find your topic
19+
20+
* Communications [Slide 13](https://docs.google.com/presentation/d/19OtCzuDTVeeIfMD39OOODGJzkV3UGM_nr7jpSNhoy2s/edit#slide=id.g5e6254b17b_4_1185)
21+
22+
* How we communicate
23+
24+
* Standards
25+
26+
* Asking tech Q’s
27+
28+
* Community Groups/Organization/SIG Tour: Josh? [Slide 29](https://docs.google.com/presentation/d/19OtCzuDTVeeIfMD39OOODGJzkV3UGM_nr7jpSNhoy2s/edit#slide=id.g5e6254b17b_4_1266)
29+
30+
* Repo Tour: Samudrala [Slide 52](https://docs.google.com/presentation/d/19OtCzuDTVeeIfMD39OOODGJzkV3UGM_nr7jpSNhoy2s/edit#slide=id.g645f82e308_0_17)
31+
32+
* How to find what you need: Alison [Slide 55](https://docs.google.com/presentation/d/19OtCzuDTVeeIfMD39OOODGJzkV3UGM_nr7jpSNhoy2s/edit#slide=id.g7eae03886b_2_18)
33+
34+
* https://cs.k8s.io/
35+
36+
Josh: I can take any of the above that someone else doesn't want.
37+
38+
#### Notes and cool ideas
39+
40+
#### Communications Tools
41+
42+
Discuss, Slack, Mailing List, Github, Twitter
43+
44+
#### Kubernetes Podcasts
45+
46+
#### Periodic Meetings
47+
48+
Office Hours, Community Meeting
49+
50+
#### Scavenger Hunt
51+
52+
Register in k8s slack, post a Hi to the New Contributor Workshop Room
53+
54+
Post a commit made by Joe Beda that contains a TODO to a special NCW Amsterdam discuss Thread. Oldest TODO wins.
55+
56+
Find and favorite a NCW Easter Egg post in the NCW Amsterdam room
57+
58+
Find and heart a k8s First Good Issue on Github
59+
60+
####
61+
Main content
62+
63+
Live PR Demo
64+
65+
Paths to Contributorship
66+
67+
Communication in the Kubernetes Community
68+
69+
Community Group and Governance
70+
71+
Orgs Overview
72+
73+
How to find what you need in the community
74+
75+
Tips and tricks to interact with the community
76+
Teach people to answer their own questions
77+
78+
[cs.k8s.io](https://cs.k8s.io/)
79+
80+
How to phrase questions
81+
82+
Limitations of GitHub searches
83+
84+
Traversing K8s docs
85+
86+
List speakers and roles for each section
87+
88+
## NCW Topics 101
89+
90+
### 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
91+
92+
**Make sure all Beginning Contributors have a workspace setup for hacking on Kubernetes**
93+
94+
### 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
95+
96+
### 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**
97+
98+
**Build Kubernetes binaries locally, and do some fun things with them.**
99+
100+
### 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**
101+
102+
**Give new contributors the experience of the Kubernetes GitHub workflow! **
103+
104+
**This task requires some setup and planning. Labels, Bots**
105+
106+
### 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**
107+
108+
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.
109+
110+
## NCW Topics 201
111+
112+
### Morning Session
113+
114+
### K/K Walkthrough 11:00 - 12:00
115+
116+
Alison
117+
118+
Guided tour of the main k/k repository, to build a broader understanding of how the codebase is structured
119+
120+
### Labels, Bots and Git Workflow 12:00 - 12:25
121+
122+
Guin & Rob
123+
124+
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.
125+
126+
### Afternoon Sessions
127+
128+
### [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
129+
130+
Ben
131+
132+
Build Kubernetes binaries locally, and do some fun things with them.
133+
134+
* Live workshop
135+
136+
* This part can be really flexible
137+
138+
* Walkthrough workspace set up
139+
140+
* Step-by-step DevProcess
141+
142+
* Fun with Go and Kind cluster ( some previous examples)
143+
144+
* Resolving set up issues
145+
146+
* Could we do something else here?
147+
148+
* Modify a controllers behavior
149+
150+
### You! Yes you can review a PR! 15-20m 14:30 - 14:50
151+
152+
Alison? With help from Tim
153+
Look at Tim’s talk from SD
154+
155+
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.
156+
157+
### [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
158+
159+
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.
160+

‎mentoring/programs/new-contributor-workshop/README.md

Lines changed: 1 addition & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -1,45 +1,8 @@
1-
# New Contributor Workshops
2-
3-
4-
## Overview
5-
6-
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.
7-
8-
This workshop is held periodically by the Kubernetes Community, but materials and processes may be used at contributor focused summits and events anywhere.
1+
# NCW Workshops
92

103
## Upcoming Workshops
114

125
None scheduled
136

147
## Previous Workshops
158
* [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)
16-
17-
## Sample Track for Beginner Workshop
18-
19-
This workshop is meant for folks who have never contributed to opensource before and/or need help setting up a Kubernetes developer environment.
20-
21-
1. Welcome
22-
1. [Live PR Demo](./live-pr-demo.md)
23-
1. [Paths to Contributorship](./contributor-paths.md)
24-
1. [Communication in the Kubernetes Community](./how-we-communicate.md)
25-
1. [Community Group and Governance Overview](./community-groups.md)
26-
1. [Kubernetes Orgs Overview](./repo-tour.md)
27-
1. [Workspace Setup](./workspace-setup.md)
28-
1. [Local Build&Test](./build-and-test.md)
29-
1. [Pull Request Exercise](./playground-exercise.md)
30-
1. [Find Your First Issue](./first-issue-help.md)
31-
32-
## Sample Track for Intermediate Workshop
33-
34-
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.
35-
36-
1. Welcome
37-
1. [Live PR Demo](./live-pr-demo.md)
38-
1. [Paths to Contributorship](./contributor-paths.md)
39-
1. [Communication in the Kubernetes Community](./how-we-communicate.md)
40-
1. [Community Group and Governance Overview](./community-groups.md)
41-
1. [Kubernetes Orgs Overview](./repo-tour.md)
42-
1. k/k Walkthrough
43-
1. [Local Build&Test](./build-and-test.md)
44-
1. Labels, Bots and Git Workflow
45-
1. [Find Your First Issue](./first-issue-help.md)

0 commit comments

Comments
 (0)