node/doc/contributing/streaming-to-youtube.md
Michael Dawson f2c4fe922b doc: move streaming instruc to doc/contributing
- make streaming instructions more discoverable by
  moving them from the TSC repo to doc/contributing
- upate the instructions to reflect current practice

Signed-off-by: Michael Dawson <mdawson@devrus.com>

PR-URL: https://github.com/nodejs/node/pull/45582
Reviewed-By: Gireesh Punathil <gpunathi@in.ibm.com>
2022-12-01 09:29:57 -05:00

4.5 KiB

Streaming Meetings to Youtube

We publicly live stream our meetings to YouTube using Zoom.

Getting Access

You need the Foundation login credentials for Zoom in order to host the meeting. The userid and password is shared through 1password.

Your YouTube Account must be a manager of the Node.js YouTube account.

To request access open an issue in the Node.js admin repository with the title being Zoom and Youtube access for X where X is the GitHub id and the YouTube ID of the person for which access is being requested. Include a short reason why access is needed(for example streaming a team meeting etc.).

Unless there are objections the request is considered approved after 48 hours.

Managing access

Youtube

To add managers or verify an account is a manager:

  1. Go to https://youtube.com
  2. Click on the Node.js icon on the right top.
  3. Select settings, select "Add or remove managers", select "Manage permissions"
  4. On that page you can use the +people at the top right of the popup to add people. It also lists all current managers.

Zoom

To share the Zoom password log into 1password, select the settings gear for thezoom-creds vault and then use Share Vault to share the vault with the new user. Use the gear to set the permissions to include only View Items and View and Copy passwords.

When adding access for a user also ask them to create a PR adding themselves to the zoom-nodejs group in the iojs.org/aliases.json file nodejs/email

Live streaming a meeting

Start and Stop the stream

  1. Login to https://zoom.us using the Foundation credentials.
  2. Go to https://zoom.us/webinar/list, find the meeting.
  3. Press "Start", it should open the meeting in the Zoom application.
  4. Go to "Participants" panel, check Attendees, promote them to panelists.
  5. Go to "... More" in toolbar, choose "Live on YouTube", it will open in browser.
  6. Choose to login to https://youtube.com with Node.js account, accept Zoom usage agreement (on first use)
  7. On the Streaming page, edit the webinar title to include the meeting date, then press the red "Go Live!" button. Troubleshooting note: at least one person has found that "Go Live!" errored with a message "Please grant necessary privilege for live streaming". Copying the link from the default browser to a different browser may work around this issue.

Every participant can choose whether to participate with or without video.

YouTube records the live stream. Recordings are made available on the Node.js channel.

The stream title is set automatically from the information in Zoom. We usually set it to YYYY-MM-DD - Meeting Name for example 2022-11-02 - Technical Steering Community Meeting.

The description should be a link to the meeting issue.

You can edit title and description on YouTube at a later time if needed.

YouTube Basic Info example text

Share the meeting once you've gone live

The meeting link should be http://www.youtube.com/c/nodejs-foundation/live.

Send it in a tweet such as:

.@nodejs Technical Steering Committee meeting live now:
http://www.youtube.com/c/nodejs-foundation/live

Adjust the Technical Steering Committee part as necessary and remove the .@nodejs if tweeting from the official twitter account.

YouTube Share input box

Check stream status

This should say online when you are streaming, and usually be green.

However, it may turn yellow and issue a warning in a "stream health" section below. Since we usually stream with static images for the video, there will often be warnings that the video bitrate is low. This is a not a problem and should almost always be ignored.

YouTube Stream Status showing Offline

Check how many people are watching

YouTube Analytics graph

Moderate the chat and solicit questions

Moderation follows the Moderation Policy. Messages can be moderated right-clicking and selecting the necessary action, such as remove.

If you participate in the chat while logged in as Node.js, it's good practice to append your initials to your messages.