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

@@ -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)

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))

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.

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.

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-<Segement Name>-<gh-handle>.mp4`` 
+
+Where 
+* ``YYYY-MM-DD`` being date, is the date video was recorded
+* ``<Segement 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)
+* ``<gh-handle>`` being the github handle of the person who recorded the video, if there are multiple presenters just add another dash and the handle. ``<gh-handle>-<gh-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 : <Segment Name> with <Presenter Name> | <Month> <Year>
+```
+
+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 <Segment Name>
+
+Link to this segments page:
+https://kubernetes.dev/docs/workshop/<page-name>
+
+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 : <Segment Name> | <Month> <Year> | 🚨🚨 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 <link to new video> 🚨🚨
+```
+
+##### 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 <link to new video> 🚨🚨
+```
+
+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="<id of your video>" title="Contributor Workshop : <Segment Name" >}}
+```
+
+## 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

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)

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
+
+<!--  What will the person reading this documentation get out of it-->
+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
+
+<!--  Some content over here -->
+
+## Another Subsection Heading
+
+<!--  Some content over here -->
+
+## Exercise : Name Of Exercise
+
+<!--  Description of a hands on activity -->
+
+### Name Of First Step
+
+<!-- Details on what this step entails -->
+
+### Name Of Second Step
+
+<!-- Details on what this step entails -->

mentoring/programs/contributor-workshop/videoguide.md

@@ -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
-