Gitlab hero border pattern left svg Gitlab hero border pattern right svg

Knowledge Sharing

On this page

Deep Dive Sessions

The goal of a Deep Dive session is to share knowledge about a particular topic, with the assumption that recipients already have some basic understanding or aptitude for the given subject. This is a particularly useful initiative within Engineering teams to mitigate dependencies between specific engineers and areas of the codebase, while also improving collaboration and product knowledge with the wider group. An example format guideline:

Note: The support team have documented similar initiatives in the handbook: Support Deep Dives and Support Bootcamps.

Preparation steps

If you're new to presenting at GitLab the steps can be a bit daunting. The steps are mostly documented elsewhere in the handbook, but are summarized here to give an overview.

Schedule the call

  1. Ensure you have a Pro zoom account by checking the web interface. This is needed so the call length isn't limited and to cloud record.
  2. Duplicate the presentation template and get a sharing URL to add to the calendar. This will avoid spamming attendees by editing the description later. You can make it private or include a WIP slide until nearer the talk.
  3. Use the Zoom App to schedule the call.
  4. Set a title as this will be used for the recording.
  5. Set it to record automatically.
  6. Have it create a Google Calendar event as this will include the Zoom URL.

At a minimum it usually makes sense to invite your team to the session, but you may also want to invite other teams if you feel the topic is particularly relevant to them (e.g. you may want to invite the Security team if you're discussing authentication).

Publicise the Deep Dive

  1. Mention it in your team's slack channel - including date, time, presentation link and zoom URL.
  2. Invite anyone who'll be particularly interested in that topic to the calendar event.
  3. Announce it on the company call.
  4. Just before the call you might want to remind people in #company-announcements on slack including the zoom/presentation links.

After the call

  1. The recording will be available through the Zoom web interface after processing.
  2. Upload it to Google Drive.
  3. Upload it to YouTube.
    • Follow the instructions in 1Password to get access.
    • Add it to your team's playlist (if available).
    • You can copy the description from a previous talk.
    • You can screenshot the first slide and use that as the video thumbnail.
  4. Create a .pdf of the talk to avoid the GitLab community needing Google Drive permissions for access.
  5. Link to the talk from relevant development docs so the community can discover it.

Preparation tips