1. You are here:
2. Handbook
3. People Group
4. Learning & Development
5. Handbook-First Approach to Interactive Learning

On this page

• Overview
  • Examples
  • Self-Paced Learning Outline
• Creating new learning material
  • Best Practices
  • Course Development Workflow
  • Documenting learning content in the handbook
  • Using iFrames
    • iframe tag examples
  • Interactivity in E-learning
  • Handbook First Video
    • Creating a Learning Video in Zoom
    • Private Video
• Toolkit
• Examples of what is not considered handbook first
• Challenges

Overview

All elearning courses at GitLab will utilize the Handbook as the Single Source of Truth (SSOT).

All our available learning material can be found on Level Up. Team members should follow these important steps to update this page every time a new course or certification is created.

Examples

1. Teams like Field Enablement use a handbook-first approach to learning in their Field Certification Program, built with Articulate 360 Storyline Suite. Learners refer to the Handbook directly within elearning courses.
2. L&D hosts Mini and Extended Challenges to engage team members in bite sized learning about a specific topic. Participants in the challenge collaborate on issues and are driven to the handbook to review learning content.

Self-Paced Learning Outline

Below is an outlined example of how the field enablement team created a handbook first learning course using Articulate 360.

1. Introduction Explain learner objectives and how to navigate the course content
2. Video Embedded in the handbook and linked from the LXP
3. iFrames Display content directly from the GitLab handbook. Before each iframe, a short description sets the expectation of the learner, time needed to read the handbook section, and a direct link to the handbook to open in a new tab
4. Intellectual property Linked directly to the course
5. Interactive Learning Quick learning checks to review previous material

Creating new learning material

Best Practices

The Instructional Designer on the Learning & Development Team maintains a Content Creation Best Practices Guide to provide team members with a guide when creating learning content.

Course Development Workflow

Instructional designers use the ADDIE instructional systems design (ISD) framework to design and develop courses. The workflow of course development will be as follows:

1. Create learning objectives
2. Design storyboard and get SME buy in
3. Outline course Handbook page
4. Develop elearning
5. Conduct a course Alpha
6. Incorporate feedback
7. Conduct a course Beta (as needed)
8. Publish course in LXP
9. Announce course launch
10. Enroll learners (as needed)

Documenting learning content in the handbook

Our goal is that each course will have an associated Handbook page including learning objectives, static learning content, quizzes, and applicable links.

Consider the following when documenting course content in the handbook:

1. Outline clear learning objectives
2. Make content discoverable. For example, leadership content should not live in the Learning and Development handbook, but instead in the Leadership handbook
3. Embed relevant YouTube videos in the handbook
4. Link to knowledge assessments
5. Cross reference any additional handbook content with links

Using iFrames

This training video provides an example of how iframes can be used to display sections of the handbook in a Rise 360 course. The same can be done in Level Up.

In the team Articulate - Rise 360 license, there is a block template for iframes. You can access this template in the block templates section and add your iframe code directly.

iframe tag examples

Consider copying and pasting the iframe tag below to apply the strategies outlined in the training. GitLab team members can access this Google doc resource for ease of access to iframe tags that can be copied and edited when building courses using Articulate360 tools.

1. <iframe src="link-to-your-page" title="title for iframe metadata" scrolling="yes" height="500" width="800"></iframe>

Interactivity in E-learning

Interactivity such as games, drag-and-drop, matching, and other interactive components in a published elearning course will not be accessible via the Handbook; however, all information conveyed to learners through the elearning course will have an associated Handbook page as needed. This will make sure that despite the interactivity of the elearning course, learners will have access to all topics covered in a course via the Handbook.

Handbook First Video

The following best practices should be followed when using video to create handbook first learning material.

1. Upload recorded video to the GitLab Unfiltered channel
2. Embed videos into the handbook on the appropriate content page
3. Ensure that embedded videos have a sub-header on the page. This will be an essential piece when linking to the handbook using iframes. Here is an example of this layout.
4. Build iframes within a lesson to display video by linking to these sub headers

Other best practices for recording new learning video include:

1. Turn on Zoom closed captionining and live transcription
2. Whenever possible, upload public videos to YouTube and use the YouTube link to share video on EdCast. This allows users to enable YouTube closed caption feature
3. Upload .vtt files with video content added to Rise courses using Articulate360 to include closed captions within the course.
4. The L&D team collaborates with Marketing Ops to use the tool Smartling to hard code closed captions to video that is not uploaded to YouTube. Video files should be shared with the Markteting Ops team who can support collaboration with Smartling. Expect anywhere between 1 day to 1 week turnaround on the video transcription based on the video length.

Creating a Learning Video in Zoom

When creating learning content, the Learning & Develpment team may work with other teams on creating videos.

Guidelines for recording a video for a course:

1. Tool: The recording will be done in Zoom.
   • Open your zoom app and click new meeting
   • Once the zoom meeting starts, make sure your video is turned on and you are unmuted.
   • Once you are ready, click the Record button, then click Record on this Computer - This will make the file save to your computer and then you can drag and drop into the designated Google Drive folder
   • If you are sharing slides during your talk you can use the share screen button as your normally would if sharing your screen in a meeting. Select the one browser that has your slides when selecting which screen to share - do not share your full Desktop as slack or other notifications could pop up in the Full Desktop mode (we don’t want to see any other applications or tabs you have open). Also, please ensure your slides are in Present mode and are taking up your full screen .
   • Once you are done recording, you can either hit Pause or Stop recording or just end the meeting. (Note: We can snip pieces of the video so if you start recording and then not start talking for 30+ seconds, we can snip that from the recording (same for any blank time at the end).
   • The file will take a moment to download.
   • Once it has downloaded, please either send it to the L&D team member that is working on the course or upload it to the appropriate folder for recordings for the course you are assisting with.
2. Appearance: We want you to be your authentic self that you're comfortable with anyone on the internet seeing. The video will be public on YouTube unfiltered.
3. Slides: Slides can be used during your presentation if you wish. Please use the provided slides template for the course.
4. Background: You can use either a GitLab branded virtual background, no virtual background if you are comfortable with the area behind your workspace being on the internet, or use the blurred feature on zoom to blur your background.
5. Completed Recording: Once the recording is completed, please add it to the appropriate Google Drive Folder or send it to the L&D team member that you have been working with. L&D will add GitLab L&D branded content to the beginning and end (intros/outtros) of the video.

Private Video

The following best practices should be followed when building learning content that includes private or internal only video.

1. Professional services shares recordings of live learning sessions directly with customers involved in each specific training via a Zoom link and recording password. These videos are not published on YouTube or to the handbook. Future iterations will include using EdCast to store and share these recordings using private Groups.

Toolkit

Use the following resources when building handbook first learning. Review the tech stack to find the current application owner at GitLab.

1. Articulate360
2. ScribehHow
3. Biteable
4. Powtoon
5. Iorad

Examples of what is not considered handbook first

Avoiding these examples can help ensure that the content you're producing follows a handbook first approach.

Example	Suggested handbook first improvement
Introducing new content within a course or Pathway	Add new content to an existing handbook page, or open a new page to document
Directly uploading a public video to the LXP	Upload the video first to GitLab Unfiltered, emebed on the correct handbook page, and either display in an Articulate course via iframe in Level Up

Challenges

• iframes can break if the page or subsection of the linked handbook is updated
• Updates to courses that are saved as SCORM files must be updated in the course creation tool and then reuploaded to the EdCast platform
• When iframes are not used, the user needs to navigate to text and video content in the handbook on a new internet tab
• New handbook/docs pages may need to be created in cases where videos should be included in a learning path