Info (warning)

warning

Due to the launch and future developments of the new SAP Learning website, we have stopped creating new learning journeys on the current infrastructure in the DITA CCMS.We are currently retiring the existing learning journeys on help.sap.com and migrating the relevant content to learning.sap.com.If you would like to create new learning journeys, consider creating them in the new format on the new SAP Learning Platform (learning.sap.com). For more information, see SAP Learning Guidelines.The content on this page covers only the editing and maintenance of the existing learning journeys on the SAP Help Portal.Contact: Viliana Encheva-Manolova

Introduction

A learning journey is a collection of different deliverables, tutorials, etc., meant to be consumed in order the users to give them a step-by-step learning experience.

Customer Access

The SAP BTP learning journeys are published both on the Help Portal (with unrestricted access) and as part of different Learning Hub editions (with subscription fees). Based on the target audience, the different Learning Hub editions may contain the full set of SAP BTP learning journeys (e.g., the Professional edition) or selected learning journeys (e.g., the Discovery Edition). The content within learning journeys is the same regardless of the publication channel.

All SAP BTP Learning Journeys on the Help Portal

Changes in Learning Journeys

If you don't have permissions to edit learning journeys, you can contact Viliana Encheva-Manolova.

Alternatively, you can log in a service request ticket to the Learning Journeys Ops team as follows:

Logging tickets for changes in the learning journeys (Internal tickets) → Service Category "Learning Journey Service" (component: XX-SER-LRN-LJS)

Getting Started

Due to the launch and future developments of the new SAP Learning Platform, we have stopped providing new trainings on how to work with the existing learning journey infrastructure. The information below is provided in case you already have passed such a training, you have the needed permissions, and need to edit and maintain existing learning journeys.

Prerequisites

You have completed the learning journey special training and have been granted the needed permissions to edit learning journeys.
Get the LJ RDP file and configure it: Getting started
When you open a tile or learning journey topic in the DITA CMS editor, change the style in order to view the editor in the correct way: Styles → Learning Journey:

Continuous Delivery

The learning journeys are created in Continuous Delivery mode. That means that the tiles and journeys are created in a DEV container version, and when ready, pushed to the SHIP container version.

For more information how to create content in Continuous Delivery, see Creating Content in Continuous Delivery.

Understanding Learning Journeys

Technical Details

All BTP tiles sub-map: loio51bf31fe3f1e47b58a7283055149a049
All BTP learning journeys sub-map: loio5ab57272ebb24ab4b46857868ccae718
DEV output: https://help.sap.com/doc/DRAFT/221f8f84afef43d29ad37ef2af0c4adf/DEV_HP_2.0/en-US/index.html
SHIP DRAFT output: https://help.sap.com/doc/DRAFT/221f8f84afef43d29ad37ef2af0c4adf/HP_2.0/en-US/index.html
SHIP PRODUCTION output: https://help.sap.com/doc/221f8f84afef43d29ad37ef2af0c4adf/HP_2.0/en-US/index.html
Related LJs sub-map: loio357fb0f2115a409aa3e5fce8e93e23cb

Standards and Guidelines

Guidelines and best practices when creating/updating a learning journey
Quality Assurance Standards (central guidelines, not everything is applicable for SAP BTP)

Creating Tiles

General recommendations:

Make sure that the same tile with the same content doesn't exist yet.
This is important as users can mark the tiles as "completed" and we would like to have this state for the same learning assets preserved between learning journeys. That means, if a user had completed a course in one learning journey and this course is linked from another learning journey, too the same tile would show up as "completed" in both learning journeys.
When you add duration, use the following convention:
<number> m/h. For example, "5 m" for 5 minutes; "1 h" for 1 hour, etc.
In most tiles, we use the short description under each link to describe the content. In special cases though, when for example within the same tile you link to the same content but in different formats (for example, roadmap slides, roadmap video, etc.), it makes sense to have only one short description under the tile title.

Types of tiles:

For the SAP BTP learning journeys, use the following tile templates only:

<div> <div>Tile Template</div> <div>Details</div> </div> <div> <div></div> <div>If you have a certification for your area/product. Currently, only 2 such certifications exist for SAP BTP, therefore, it is quite unlikely that you will need to use this type of tile.</div> </div> <div> <div></div> <div> <p>When you need to link to openSAP courses or chapters. Make sure that you add the course code, too.</p> <p>Note: If you need to link to chapters of an openSAP course only, provide the link to this chapter and add the following text as a Footnote:</p> </div> </div> <div> <div></div> <div>When you need to link to courses, provided by SAP. Make sure that you add the course code, too.</div> </div> <div> <div></div> <div>When you would like to include a link to another learning journey. Usually, you would add that tile to the "Expand your skills" section. Make sure that the learning journey you link to is included in the same buildable map (if you are linking to other SAP BTP learning journeys, then you don't need to worry about this). Include the target learning journey also in the following sub-map <strong>loio357fb0f2115a409aa3e5fce8e93e23cb</strong>.</div> </div> <div> <div></div> <div>When you link to What's New/Release Notes information.</div> </div> <div> <div></div> <div>When you link to resources that are not courses, what's new, or related learning journey types of information. For example, use this tile if you link to SAP Help Portal, tutorials in the Tutorial Navigator, blogs, vidoes, other external links, etc.</div> </div> <div> <div></div> <div>This is a tile that allows you to add free text. This is a rarely used type of tile. You could use it if you would like to add descriptive text to an entire group of tiles and the short descriptions for the scenarios or the subgroups within the scenarios are not enough to describe the content.</div> </div>

You will see other tile type templates in the templates list that might seem suitable for you but please do not use them, as they are used only in specific learning journey sets and the visualization for those sets is different. That

means, those tile types will probably not work well for the SAP BTP learning journeys, if at all.

More information:

Guidelines

The following are a set of guidelines that could help you decide how to select and structure the content for your learning journeys.

Overall:

Keep it simple. Resist the temptation to include every single training material related to the topic. The Learning Journey should be a minimal set of recommended content to achieve a specific learning goal (e.g., achieve Certification).
Focus on CF-related tutorials and information. If you absolutely need to link to Neo-related content, try to isolate it so that it can be easily removed later. If you need to provide both CF- and Neo-related content, a better alternative could be to create separate CF-only and Neo-only learning journeys.
If you would like to link to the same information but in different formats, group the links together in one tile. E.g., you can link to a road map pdf and to a video presentation of the road map but group them together in one tile. In this case, you can have the short description only once and only indicate the format version for each link.
The information in each section can be separated into smaller custom groups with custom titles, if needed. That means, you can have subsections within the main sections. For example, you can separate the Become competent in subgroups, such as "Tutorials", "Topic A", Topic B", etc.
If you plan to create additional information, we can add placeholders as well and only add the links once they are available.

Learning Journey Sections:

Start with an overview: should contain an introductory/overview information about the topic. This section should not be too long. As a rule of a thumb, this section should contain 1-2 h of overview information. Still, more is possible, if needed.
What would fit good in this section is for example, a 1h presentation about the topic, an overview video, a TechEd session recording, a blog, explaining the basics.
Become competent: use this section to show and allow the users to quickly try out and get hands-on experience. That is, it makes sense to link to quick start tutorials (if available) or any other type of tutorials that will be useful for the user. You can add here all additional information that helps the user understand and learn the topic, such as links to documentation, blogs, videos, openSAP courses, presentations, etc.
Stay current: add here links to information, that is regularly updated and will allow the users to get regular news about the area/product. For example, What’s New information, road map links, twitter accounts, facebook accounts, newsletters, webinars, etc. should all be added here.
Expand your skills: should contain advanced information that allows the users to learn more complicated aspects. You can also use this section to link to additional or related information, for example official SAP courses, advanced documentation or tutorials, related learning journeys.

Support

Learning Journeys for SAP CP - a DL for UA authors, working on BTP-related learning journeys. The DL is open for subscriptions and owned by Viliana Encheva-Manolova.