diff options
Diffstat (limited to 'mentoring/programs')
| -rw-r--r-- | mentoring/programs/contributor-workshop/resources/guides/obssettings.png | bin | 0 -> 75253 bytes | |||
| -rw-r--r-- | mentoring/programs/contributor-workshop/resources/guides/videoguide.md | 276 | ||||
| -rw-r--r-- | mentoring/programs/contributor-workshop/resources/guides/videouploadguide.md | 97 |
3 files changed, 187 insertions, 186 deletions
diff --git a/mentoring/programs/contributor-workshop/resources/guides/obssettings.png b/mentoring/programs/contributor-workshop/resources/guides/obssettings.png Binary files differnew file mode 100644 index 00000000..b8946ccd --- /dev/null +++ b/mentoring/programs/contributor-workshop/resources/guides/obssettings.png 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 @@ +<!-- omit in toc --> # 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 : ??? + + ### 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 +  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-<Segement Name>-<gh-handle>.mp4`` +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>`` +Where -For example +- ``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>`` -``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 : <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/ -``` +> 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 : <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 +## 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 : <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 + +## Update the Playlist + +Update the youtube playlist with the segment recording. |
