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 GitLab Learn.
Team members should follow these important steps to update GitLab Learn every time a new course or certification is created.
The GitLab Field Enablement team uses a handbook-first approach to learning in their Field Certification Program
For example, in order to learn more about a particular topic tied to the Field Certification, learners will be able to refer to the Handbook within the elearning course instead of having to open a new browser tab and manually navigating to the Handbook.
The Field Enablement team will utilize the Articulate 360 Storyline Suite as the main course authoring tool. In Storyline, a Handbook-first approach is achieved by adding a web object on a slide so learners can access the Handbook on that particular topic.
The L&D team 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.
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 the Field Certification program via the Handbook.
Instructional designers will use the ADDIE instructional systems design (ISD) framework to design and develop Field Certification courses using Articulate 360. The workflow of course development will be as follows:
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:
Google Chrome browsers can use the copy link to highlight feature. This will highlight a specified section of the handbook when clicked.
Note that this will only work with Google Chrome, so be mindful of the audience you are reaching before using this kind of link.
This kind of link is powerful to use when directing learners to the handbook as it clearly marks where they should start and stop reading.
Here is an example of how to create these links:
Copy link to highlight
It's important to note that high traffic or frequently updated handbook pages might result in broken links if the first or last word in a highlighted section is edited.
Content in the EdCast LXP at GitLab will adopt this handbook-first approach to learning. You can read more best practices about building content in the LXP in our GitLab Learn admin docs. Examples of ways that the handbook is utilized for learning in the LXP include:
The following best practices should be followed when using video to create handbook first learning material.
The following best practices should be followed when building learning content that includes private or internal only video.
Not all video on the GitLab Unfiltered channel is handbook first. In order to be sure that video in EdCast aligns with the handbook first best practices outlined above, we've elected to turn off the GitLab Unfiltered API in EdCast.
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.
In addition to making video learning content handbook first, consider these best practices when recording video training or delivering live training:
.vttfiles with video content added to Rise courses using Articulate360 to include closed captions within the course.
When creating learning content, the Learning & Develpment team may work with other teams on creating videos.
Guidelines for recording a video for a course:
Recordbutton, 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
share screenbutton 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
Presentmode and are taking up your full screen .
Stoprecording 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).
Below is an outlined example of how the field enablement team created a handbook first learning course for the EdCast LXP using Articulate 360.
Articulate360 is a powerful course creation tool. Below are a set of best practices and tips for creating handbook first courses using Articulate360:
Duplicate> and then rename using your course title
This training video provides an example of how iframes can be used to display sections of the handbook in a Rise 360 course.
In the team Articulate - Rise 360 license, there is a block template for iframes. You can access this template in the the
block templates section and add your iframe code directly.
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.
<iframe src="link-to-your-page" title="title for iframe metadata" scrolling="no" height="XX"></iframe>
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 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 or link from a SmartCard in the LXP|