GitLab Professional Services
Accelerate your software lifecycle with help from GitLab experts
Popular GitLab use cases
Enterprise Small Business Continuous Integration (CI/CD) Source Code Management (SCM) Out-of-the-box Pipelines (Auto DevOps) Security (DevSecOps) Agile Development Value Stream Management GitOpsGitLab Professional Services
Accelerate your software lifecycle with help from GitLab experts
Popular GitLab use cases
Enterprise Small Business Continuous Integration (CI/CD) Source Code Management (SCM) Out-of-the-box Pipelines (Auto DevOps) Security (DevSecOps) Agile Development Value Stream Management GitOpsAll elearning courses at GitLab to the will utilize the Handbook as the Single Source of Truth (SSOT).
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 Challanges 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:
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.
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
Course Template
> Duplicate
> and then rename using your course titleThis 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 |