Skip to content

Latest commit

 

History

History
237 lines (141 loc) · 11 KB

MEETINGS_ORGANIZATION.md

File metadata and controls

237 lines (141 loc) · 11 KB
Raw

This document covers the aspects of different meeting organizations at AsyncAPI.

FAQ

What do I need to schedule a meeting?

To schedule a meeting, you need to be:

  • one of the licensed Zoom users associated with the AsyncAPI Zoom account. It is required because only licensed users can start meetings, live transcripts, and streaming.
  • GitHub Action workflow for Ad Hoc meeting scheduling should be updated. Newly licensed users should be added as alternative hosts.
  • a member of GitHub team called meetings-organizers. This is required because only repository maintainers can manually trigger GitHub Actions workflows. This group has a Maintain role in the community repository where meeting automation is implemented.
  • a member of a team in the AsyncAPI Restream account. It is required because hosts must log in to Restream before streaming the meeting from Zoom and modify the stream's title that will appear on social platforms.
  • a member of the AsyncAPI YouTube account. It is required because hosts need to add live stream recordings to the proper YouTube Playlist after the meeting is over to improve recording discoverability.

What meetings do we have?

  • Regular meetings: regular meetings with a dedicated area of interest and individual brand (Examples: Community Meeting or Thinking Out Loud)
  • Ad Hoc meetings: meetings for topics that do not match any regular meetings and should be organized separately. Every official AsyncAPI Zoom licensed user should have the right to schedule it.

How do I schedule a new meeting?

  1. Go to Actions tab
  2. Select one of the workflows that start with Schedule. Choose one that represents the meeting you want to schedule.
  3. Click the Run workflow button.
  4. Provide data required by the form and click the Run workflow button within the form.

We have an automated workflow in place:

  1. Automation starts after clicking Run workflow. (Unless there is another GitHub Actions outage and proper events are not delivered to automation 😃 )
  2. It creates a new meeting in Zoom. It is, by default, configured to support live streaming
  3. It creates a GitHub issue with all details about the meeting
  4. It creates a new Google Calendar entry with special metadata containing the GitHub issue number
  5. It sends a tweet with information about a newly scheduled event

What are my responsibilities as meeting host?

Technically, there are two types of meetings:

  • Zoom-first: The meeting takes place on Zoom and is streamed to different channels through integration with Restream.io. The goal is to enable as many people as possible to join the live conversation.
  • Restream-first: The meeting takes place on Restream and is streamed to different channels. These meetings are focused on showing or explaining some topic without a live audio conversation with the audience.

Zoom-first

This is what you need to do to kick it off:

  1. Start your meeting by opening a Zoom meeting. Make sure you are logged into Zoom with your AsyncAPI licensed account.

  2. Log into Restream.io and select Set up for OBS, Zoom, etc. option:

  3. Click Update Titles card:

  4. Provide title and description:

    • Title for the live stream that corresponds with the meeting you just started,
    • Meeting description must be provided even if the field is empty; otherwise, the old one from other streams will be used.

  5. In Zoom, click the Live Transcript button to start transcribing the meeting:

  6. Confirm transcriptions with Enable button:

  7. Click More:

  8. Select Live on Custom Live Stream Service option to start streaming to Restream and, therefore, to official AsyncAPI social networks:

Restream-first

You must start with YouTube first, even though Restream can directly stream there. It is because by

This is what you need to do to kick it off:

  1. In YouTube, click on your profile picture and select Switch account:

  2. Select AsyncAPI. If you do not see it on the list, it means you did not have all the access rights needed to set up a live stream:

  3. Click on Create and select Go live:

  4. Once a new live stream is created, in the list of Upcoming streams, click View in Live Control Room icon next to your live stream:

  5. Enable Closed captions:

  6. Log into Restream.io and select Start with Studio option:

  7. After enabling the audio, video and providing the name, you will see a Restream Studio.

  8. Edit the title and description of the stream:

  9. Provide title and description and click Next:

    • Title for the live stream that corresponds with the meeting you just started,
    • Meeting description must be provided even if the field is empty; otherwise, the old one from other streams will be used.

  10. Edit YouTube destination:

  11. Make sure you do not create a new event, but select the one you already created on YouTube, with closed captions on:

  12. You are ready to Go Live

Post meeting

Once the meeting is over, if applicable:

  1. Provide related GitHub Issue meeting notes and then close the issue.
  2. Login to YouTube and add the recorded live stream to the respective YouTube Playlist.

How can I get notified about upcoming meetings?

Subscribe to the AsyncAPI Newsletter to get information about upcoming meetings.

We have an automated workflow in place:

  1. Automation starts every Friday at midnight
  2. It gets information from Google Calendar about all the meetings scheduled for the upcoming week
  3. It schedules a MailChimp campaign to send emails with a list of meetings. It's sent on Friday at 11 AM in the subscriber's time zone

Where can I find the AsyncAPI calendar?

How do I cancel a meeting?

If you need to cancel a meeting, simply close the corresponding meeting issue.

We have an automated workflow in place:

  1. Automation starts when the GitHub issue is closed
  2. It checks if a closed issue represents a future event
  3. It removes meetings from the AsyncAPI Google Calendar

How do I register for a new regular meeting?

Start discussion in community repository. Explain the idea and justify why it requires a separate meeting. We currently have approval from the Technical Steering Commitee to pay for up to 8 Zoom licenses.

Once a new meeting is approved, add a new workflow like this one and a new GitHub issue template like this one.

How can I become a host?

Once your Regular meeting gets approved, contact Fran Mendez so he can give you access to all required tools.

How do I publish broadcasted meetings as podcasts?

Why do we need this feature?

  • Some people prefer to listen to the video/livestream as an audio (podcast) instead of watching the video.

  • The goal is to upload our AsyncAPI video/live streams on Spotify For Podcasters platform, ultimately allowing the listener to play the episodes on Spotify. Almost every YouTube video can be converted into a podcast.

Who can upload the videos?

  • The workflow can only be triggered by a person with write access to the master branch of the asyncapi/community repository.

What is needed?

  • The YouTube video ID is needed to trigger the workflow.

What is YouTube video ID?

  • A YouTube video ID is a unique combination of characters that identifies a specific video on the YouTube platform. It's used in the URL of the video to direct users to the exact video they want to watch. The video ID is typically a sequence of letters, numbers, and special characters that generally comes after the "v=" parameter in the URL.
  • More examples of video ID are given below: ⬇️

How to find YouTube ID?

Let's take this video link, for example: https://www.youtube.com/watch?v=3rg_7hIb9PQ.

Here the video ID is the word/entity after https://www.youtube.com/watch?v=, i.e., 3rg_7hIb9PQ

List of different types of YouTube links

Step-by-step procedure

Here is an example with a procedure on how to use this workflow:

  1. Go to the Actions section on GitHub.
  2. Scroll down the menu on the left-hand side.
  3. Click on the Upload Episode from YouTube To Spotify for Podcasters option.
  4. Click on the Run Workflow button.
  5. Provide the YouTube ID in the box.
  6. Click on Run workflow button.
  7. Wait for the workflow to finish. (Depending on video size, it may take some time to upload, so please have patience. Thank you.) .
  8. A few moments later....Hurray! Your episode is now uploaded successfully!

You can also modify description and other information for uploaded podcast directly in Spotify:

  1. Go to https://podcasters.spotify.com/.
  2. Login using AsyncAPI account.
  3. Go to Episodes section. There, you will see your latest upload.
  4. Perform edits and save them.