kubernetes
/
community
mirror of https://github.com/kubernetes/community.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #6520 from pymander/ela/update-youtube-guidelines 

Update the YouTube guidelines
This commit is contained in:
Kubernetes Prow Robot 2022-04-08 10:28:48 -07:00 committed by GitHub
parent b3e46dc171 dd2f3d365b
commit 70d8661d58
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 175 additions and 160 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

335
communication/youtube/youtube-guidelines.md
View File

@ -1,53 +1,37 @@
--- ---
title: "YouTube Guidelines" title: YouTube Channel Guidelines
description: | description: |
Overview of community YouTube practices and admin responsibilities. This is an overview of community YouTube practices and admin responsibilities.
--- ---
<!-- omit in toc --> YouTube serves as the primary means of distribution for recorded Kubernetes
# YouTube Channel Guidelines community content including Zoom recordings, official project workshops and
YouTube serves as primary means of distribution for recorded Kubernetes
community content including Zoom recordings, official project Workshops and
Contributor Summit sessions. Contributor Summit sessions.
- [Code of Conduct](#code-of-conduct)
- [Admins](#admins)
- [Meeting Playlists](#meeting-playlists)
- [Uploading Guidelines for Collaborators](#uploading-guidelines-for-collaborators)
- [Admin Responsibilities](#admin-responsibilities)
- [Moderator Expectations and Guidelines](#moderator-expectations-and-guidelines)
- [Trimming and Editing Recordings](#trimming-and-editing-recordings)
- [Automation](#automation)
- [Descriptions & Playlists](#descriptions--playlists)
- [Thumbnails](#thumbnails)
- [Streaming Events](#streaming-events)
- [Migrating Content](#migrating-content)
## Code of Conduct ## Code of Conduct
Kubernetes adheres to the [Kubernetes Code of Conduct][coc] throughout the Kubernetes adheres to the [Kubernetes Code of Conduct][coc] throughout the project,
project, and includes all communication mediums. and includes all communications such as YouTube.
## Admins ## Admins
- Check the [centralized list of administrators] for contact information. - Check the [centralized list of administrators][admins] for contact information.
- To contact the admin group in Slack, ping `@youtube-admins` in the `#sig-contribex` - To contact the admin group in Slack, ping `@youtube-admins` in the
Slack channel. `#sig-contribex` Slack channel.
## Meeting Playlists ## Meeting Playlists
The [Kubernetes YouTube Channel] has separate playlists for each SIG, WG, UG The [Kubernetes YouTube Channel][] has separate playlists for each SIG, WG, UG
meeting recordings, as well as recordings of other recurring events such as the meeting recordings, as well as recordings of other recurring events such as the
Kubernetes [Community meeting], [Office Hours], [Meet our Contributors] and Kubernetes [community meeting][], [Office Hours][], [Meet our Contributors][]
others. and others.
[Subprojects], in addition to SIGs, WGs, UGs may request their own playlists [Subprojects][], in addition to SIGs, WGs, UGs may request their own playlists
to better target their contributors and increase general discoverability. to better target their contributors and increase general discoverability.
To better serve the community, [collaboration] has been enabled to share the To better serve the community, [collaboration][] has been enabled to share the
management of the playlists. Anyone with the appropriate link to the particular management of the playlists. Anyone with the appropriate link to the particular
playlist can upload videos _to that particular playlist_ (links & playlists are playlist can upload videos *to that particular playlist* (links & playlists are
one-to-one). one-to-one).
Each group's playlist link will be shared with the group's leadership via Slack Each group's playlist link will be shared with the group's leadership via Slack
@ -56,191 +40,222 @@ Hours, will be shared with the appropriate point(s) of contact.
### Uploading Guidelines for Collaborators ### Uploading Guidelines for Collaborators
**NOTE:** If you're using a G Suite account you may need to [loosen the **NOTE:** If you're using a Google Workspace account (formerly known as G Suite)
permissions in your YouTube settings]. If you have any questions reach out to you may need to [update the permissions in your YouTube settings][]. If you have
the [YouTube admins] or [SIG Contributor Experience]. any questions, reach out to the [YouTube admins][] or
[SIG Contributor Experience][]. You may need to reach out to someone at your
organization if you do not have access to Google Workspace Admin permissions.
**NOTE:** Both public and private steering meeting recordings should be made public. **NOTE:** Both public and private steering meeting recordings should be made
public.
With collaboration comes great responsibility. Playlist collaborators in the With collaboration comes great responsibility. Playlist collaborators in the
community must use it responsibly and are subject to the following guidelines: community must use it responsibly and are subject to the following guidelines:
- Group leaders or other appropriate point(s) of contact are the primary - Group leaders or other appropriate point(s) of contact are the primary
managers for the playlist, once collaboration is configured. YouTube admins managers for the playlist, once collaboration is configured. YouTube admins
should **only** be contacted if the issue cannot be resolved by one of the should **only** be contacted if the issue cannot be resolved by one of the
playlist owners. playlist owners.
- Upload responsibilities belong to the group leaders or other appropriate - Upload responsibilities belong to the group leaders or other appropriate
point(s) of contact. YouTube admins should **only** be contacted if the contacts. YouTube admins should **only** be contacted if the issue cannot be
issue cannot be resolved by the playlist owners. resolved by the playlist owners.
- Please post only related content; for example: meeting recordings, in the - Please post only related content, for example meeting recordings, in the
appropriate playlists. appropriate playlists.
- Posting of any exceedingly inappropriate content (i.e. NSFW content) will - Posting of any inappropriate content (i.e. NSFW content)
result in ***immediate*** suspension of privileges. will result in ***immediate*** suspension of privileges.
- All posted videos should use the naming convention: - All posted videos should use the naming convention: \<Name of Playlist's
`Kubernetes [Name of Playlist’s Group] YYYYMMDD` Group\> YYYYMMDD
- **Example:** `Kubernetes SIG Service Catalog 20161129` - **Example:** SIG Service Catalog 20161129
- Playlists should be organized chronologically for ease of use. This can be - Playlists should be organized chronologically for ease of use. This can be
done by updating the default ordering of the Playlist: done by updating the default ordering of the Playlist:
- From within the Playlist settings, click on the **Basic** Tab. - From within the Playlist settings, click on the **Basic** Tab.
- From the **Ordering** dropdown select "Date added (newest)". - From the **Ordering** dropdown select "Date added (newest)".
- Save the changes and the order should automatically be updated. - Save the changes and the order should automatically be updated.
- Please do not remove any already-published content from the playlists without - Please do not remove any already-published content from the playlists
checking with the YouTube admins. without checking with the YouTube admins.
- For any small issues that arise, for example improper naming or ordering, you - For any small issues that arise, for example improper naming or ordering,
may be asked by the YouTube admins to attempt to resolve the issue yourself. you may be asked by the YouTube admins to attempt to resolve the issue
yourself.
- Any egregious or habitual violations (3 or more per quarter) of the above - Any egregious or habitual violations (3 or more per quarter) of the above
rules will result in suspension of collaboration privileges for the particular rules will result in suspension of collaboration privileges for the
individual or for the entire playlist if the individual can’t be identified. particular individual or for the entire playlist if the individual can't be
- If an individual is suspended, the playlist link will be remade and the new identified.
link will be shared with the non-offending individuals. - If an individual is suspended, the playlist link will be remade and the
- If playlist collaboration is suspended, the uploading and management of new link will be shared with the non-offending individuals.
the playlist will be handled by the YouTube admins. Uploading the - If playlist collaboration is suspended, the uploading and management of
problematic group's playlist will not be considered a priority, and delays the playlist will be handled by the YouTube admins. Uploading the
in uploading should be expected. problematic group's playlist will not be considered a priority, and
delays in uploading should be expected.
## Admin Responsibilities
## Admin Responsibilities The role of the Youtube Admins is to help maintain a robust YouTube channel that
is valuable to contributors and upholds our transparency goals as laid out by
Purpose: Help maintain a robust YouTube channel that is valuable to contributors our governance documents.
and upholds our transparency goals as laid out by our governance docs.
### Moderator Expectations and Guidelines ### Moderator Expectations and Guidelines
Moderators should adhere to the general Kubernetes project Moderators should adhere to the general Kubernetes project
[moderation guidelines]. [moderation guidelines][].
Moderation responsibilities for YouTube admins is minimal and is centered around Moderation responsibilities for YouTube admins is minimal and is centered around
checking and removing any potential comments that would violate the [Code of checking and removing any potential comments that would violate the
Conduct][coc]. Any potential violations should sent to <conduct@kubernetes.io>. [Code of Conduct][coc]. Any potential violations should be sent to
<conduct@kubernetes.io>.
### Trimming and Editing Recordings ### Trimming and Editing Recordings
YouTube admins are asked to help [trim] and [edit] recordings that come into the YouTube admins are asked to help [trim][] and [edit][] recordings that come into
video queue. the video queue.
Examples:
#### Examples:
Certain events such as the Contributor Summits are not uploaded directly to Certain events such as the Contributor Summits are not uploaded directly to
YouTube and require editing. YouTube and require editing.
A Zoom recording may have significant dead-space leading the meeting itself
and also at the end as we end the stream. A Zoom recording may have significant dead-space leading the meeting itself and
A SIG Meeting needs to be edited to to make sure it's clear (ie "Kubernetes also at the end as we end the stream.
Special Interest Group ContribEx 20190303 Meeting").
A SIG Meeting needs to be edited to make sure it's clear (ie "Kubernetes Special
Interest Group ContribEx 20220131 Meeting").
Make sure to save a copy of the video first before making adjustments as this Make sure to save a copy of the video first before making adjustments as this
can delete the original if not careful. When in doubt, ask. can delete the original if not careful. When in doubt, ask.
### Automation ### Automation
We have been playing around with various integration features with our other **Note:** There is always room for improvement! As such, the community is open
productivity tools and would love to do more! Reach out if you can help. to trying various integration features or other productivity tools that might
improve the job of admins and help make things more streamlined. Please, reach
out if you can help or have any ideas.
One feature that we've implemented with several SIGs is splain.io. This tool #### Splain.io
creates a pipeline between zoom and youtube.
Here's what you need: One feature used by several SIGs is splain.io. This tool creates a pipeline
- UserName and Password for the zoom license account. You'll need a zoom admin between Zoom and youtube for easier workflows. To use splain.io please follow
or the admin of the license (ex: SIG Chair) to either provide it to you or reset the steps outlined below.
it to a new one.
- Kubernetes YouTube admin credentials
- A correctly set up recurring meeting with a start and end time (this is
important) - check [zoom guidelines] for more details
Steps: **Items needed to use splain.io:**
- Install splain: https://marketplace.zoom.us/apps/WPKzwuoLQDuj_gPs68AQxw
- Connect the zoom account - UserName and Password for the Zoom license account. You will need a Zoom
- Connect YouTube account admin or the admin of the license (ex: SIG Chair) to either provide it to
- Click the `manage` tab next to App Info and scroll to the config button, click you or reset it to a new one.
- The splain dashboard will display: make sure the box for make videos private is - Kubernetes YouTube admin permissions
checked so we can edit before it goes live. - A correctly set up recurring meeting with a start and end time (this is
- Test that it works important) - check [Zoom guidelines][] for more details
- Enjoy
**Steps:**
1. Install splain: <https://marketplace.zoom.us/apps/WPKzwuoLQDuj_gPs68AQxw>
2. Connect the Zoom account
3. Connect YouTube account
4. Click the manage tab next to App Info, and then scroll to locate the config
button.
5. Click **Config**
6. The splain dashboard opens: make sure the box for **Make videos private** is
checked so we can edit before it goes live.
7. Test that it works.
8. Enjoy.
The following SIGs and groups are currently running splain.io: The following SIGs and groups are currently running splain.io:
- [SIG Auth](/sig-auth/README.md)
- [SIG Contributor Experience](/sig-contributor-experience/README.md)
- [SIG Docs](/sig-docs/README.md)
- [SIG Network](/sig-network/README.md)
- [Steering Committee](/committee-steering/governance/README.md)
- [WG Data Protection](/wg-data-protection/README.md)
The main zoom admin account which holds Meet Our Contributors and others (if - [SIG Auth][]
you log in to splain using this account, all of the other accounts will be - [SIG Contributor Experience][]
logged here) - [SIG Docs][]
- [SIG Network][]
- [SIG Release][]
- [Steering Committee][]
- [WG Data Protection][]
- The main Zoom admin account which holds Meet Our Contributors and others (if
you log in to splain using this account, all of the other accounts will be
logged here)
TODO - look into splain.io's google drive to youtube pipeline. Also look into ### Descriptions and Playlists
using the gsuite contributors@ account to use the API for zoom cloud -> google
drive -> youtube.
### Descriptions & Playlists
Each video that comes into the queue needs to be added to a playlist, set to Each video that comes into the queue needs to be added to a playlist, set to
public, and added context to the description. public, and have contextual information added to the description.
**Example description:**
Example description:
Kubernetes Contributor Experience Special Interest Group Weekly Meeting. Check Kubernetes Contributor Experience Special Interest Group Weekly Meeting. Check
here (link to sig list) for a complete list of SIGs and when they meet. Join us! here (link to sig list) for a complete list of SIGs and when they meet. Join us!
Please note the following items: Please note the following items:
* The date must be in title and description
* The date format must be YYYYMMDD
* The section titled `Is this video made for kids?` should not be altered for search reasons
Below are a good and incorrect example: - The date must be in title and description
* Incorrect description: `Data Protection WG Bi-Weekly Meeting for 2/26/2020` - The date format must be YYYYMMDD
* Correct description: `Data Protection WG Bi-Weekly Meeting for 20200226` - The section titled "Is this video made for kids?" **should not** be altered
for search reasons
A short video tutorial of the editing of descriptions and playlists can be found here: Below is an example:
* https://youtu.be/IbZ2wnvu_Zs
- Incorrect description: `Data Protection WG Bi-Weekly Meeting for 2/26/2020`
- Correct description: `Data Protection WG Bi-Weekly Meeting for 20200226`
A short video tutorial of the editing of descriptions and playlists can be found
here:
- <https://youtu.be/IbZ2wnvu_Zs>
### Thumbnails ### Thumbnails
TODO - someone help us with better thumbnails to lay over the videos! There have been ongoing conversations about how to create and manage better
thumbnails for videos using some kind of standard. If you're interested in
helping with thumbnails, please reach out to the YouTube Admins. They would love
to hear from you.
### Streaming Events ### Streaming Events
YouTube admins with a system capable of streaming may be asked to stream public YouTube admins with a system capable of streaming may be asked to stream public
Kubernetes Community events such as the weekly [Community Meeting], Kubernetes Community events such as the weekly [Community Meeting][],
[Office Hours], [Meet our Contributors], or other publicly streamed events. For [Office Hours][], [Meet our Contributors][], or other publicly streamed
detailed information about streaming, see our [Streaming Config] events. For detailed information about streaming, see our [Streaming Config][].
### Migrating Content ### Migrating Content
In certain cases, such as archiving an inactive SIG or Working Group it might be In certain cases, such as archiving an inactive SIG or Working Group, it might
useful to grab content from other channels. It is currently NOT POSSIBLE to move be useful to grab content from other channels. It is currently NOT POSSIBLE to
content from one YouTube channel to another, so the content must be downloaded move content from one YouTube channel to another, so the content must be
and then reuploaded to the Kubernetes channel downloaded and then reuploaded to the Kubernetes channel.
1. Download [youtube-dl], which makes it easier to bulk download videos. 1. Download [youtube-dl][], which makes it easier to bulk download videos.
2. Download the channel or playlist with: `youtube-dl <url>` 2. Download the channel or playlist with: `youtube-dl <url>`
3. Clean up the filenames as they are used to generate new titles. Do this 3. Clean up the filenames as they are used to generate new titles. Do this
locally since it is easier than doing it per video in the YouTube web UI. locally since it is easier than doing it per video in the YouTube web UI.
4. Create a new playlist for the content on the Kubernetes channel, set it to Private. 4. Create a new playlist for the content on the Kubernetes channel, set it to
5. Upload the videos to the Kubernetes Channel. Private.
6. Ensure titles and metadata are accurate, allow time to pass for YouTube to 5. Upload the videos to the Kubernetes Channel.
generate thumbnails and process the videos. 6. Ensure titles and metadata are accurate, allow time to pass for YouTube to
7. Once videos are finalized, set the playlist to Public to publish them. generate thumbnails and process the videos.
7. Once videos are finalized, set the playlist to Public to publish them.
[coc]: /code-of-conduct.md
[coc]: /code-of-conduct.md [admins]: /communication/moderators.md
[Kubernetes YouTube Channel]: https://www.youtube.com/channel/UCZ2bu0qutTOM0tHYa_jkIwg [Kubernetes YouTube Channel]: https://www.youtube.com/channel/UCZ2bu0qutTOM0tHYa_jkIwg
[collaboration]: https://support.google.com/youtube/answer/6109639 [community meeting]: /events/community-meeting.md
[loosen the permissions in your YouTube settings]: https://support.google.com/a/answer/6212415 [Office Hours]: /events/office-hours.md
[SIG Contributor Experience]: /sig-contributor-experience [Meet our Contributors]: /events/meet-our-contributors.md
[centralized list of administrators]: /communication/moderators.md [Subprojects]: /governance.md#subprojects
[YouTube admins]: /communication/moderators.md#YouTube-Channel [collaboration]: https://support.google.com/youtube/answer/6109639
[trim]: https://support.google.com/youtube/answer/9057455?hl=en [update the permissions in your YouTube settings]: https://support.google.com/a/answer/6212415
[edit]: https://support.google.com/youtube/topic/9257530?hl=en&ref_topic=9257610 [YouTube admins]: /communication/moderators.md#YouTube-Channel
[Community Meeting]: /events/community-meeting.md [SIG Contributor Experience]: /sig-contributor-experience/README.md
[Office Hours]: /events/office-hours.md [moderation guidelines]: /communication/moderation.md
[Meet our Contributors]: /mentoring/programs/meet-our-contributors.md [trim]: https://support.google.com/youtube/answer/9057455?hl=en
[Streaming Config]: ./streaming-config.md [edit]: https://support.google.com/youtube/topic/9257530?hl=en&ref_topic=9257610
[Subprojects]: /governance.md#subprojects [Zoom guidelines]: /communication/zoom-guidelines.md
[moderation guidelines]: /communication/moderation.md [SIG Auth]: /sig-auth/README.md
[zoom guidelines]:/communication/zoom-guidelines.md [SIG Docs]: /sig-docs/README.md
[youtube-dl]: https://ytdl-org.github.io/youtube-dl/index.html [SIG Network]: /sig-network/README.md
[SIG Release]: /sig-release/README.md
[Steering Committee]: /committee-steering/governance/README.md
[WG Data Protection]: /wg-data-protection/README.md
[Streaming Config]: /communication/youtube/streaming-config.md
[youtube-dl]: https://ytdl-org.github.io/youtube-dl/index.html