Overview

This is an overview for the entire Learning Object. It is a specialization of a DITA concept called slscontext. It is an overview of all the content in the Learning Object. Since its purpose is to support the instruction of this learning object (as opposed to providing the instruction itself), this overview is an instructional object.

The content of the learning object should be so small and focused that you only need one objective and that objective gets authored here in the overview topic. So here it is:

After completing this section you will be able to:

Fundamentals of Course Structures

This is a DITA concept information object that contains training content in support of objected of the overall Learning Object. It is an standard DITA concept topic; it is not a specialization of any DITA topic. It is a sibling information object to the others inside this Learning Object. It is sequenced as it needs to be for training flow in the information object set inside this Learning Object.

The high level course structures used in the SLS CMS define the size, shape and contents of the training deliverable. The figure shows these structures graphically and subsequent sections in this learning object will speak about some of the details.

The data model or markup used for structuring the training content of SLS CMS is that of the Darwin Information Type Architecture (DITA) 1.1.

The Course Map

DITA uses the term map for that XML model that collects child components which are references to topics or other (sub) maps. SLS is using two specializations of a DITA map. The top level map is called an slstdmap and defines a training deliverable (TD). The other map speciaization is to wrap a Learning Object and is called an slslearningobj. Call the top level slstdmap a chunk, or a course, a training deliverable or a TD (touchdown). Whatever term you use, it needs to be 4 hours or less in length.

As you see in the figure the slstdmap contains child groupings (<topicgroup>s) that contain pointers (using <topicref> elements) to the Learning Objects themselves. You might think of these <topicgroup>s as legacy ILT modules because they are units aggregated as a course and they themselves also collect smaller Learning Objects, which are now considered to be legacy ILT enabling objective sized content pieces.

Note: Avoid the temptation to think of ILT legacy analogies too often. The topic oriented writing style for the new SLS chunked or TD content is different than the monolithic writing style we have been using. In other words, a legacy EO is content written differently than that for a Learning Object but as a guideline, the amount or size of the Learning Object and legacy EO are comparable, as are their position in the hierarchy of the overall course structure.

Exercise in <topicgroup>

It is important to point out the <topicref> pointing to the exercise in the topic group. These are analogous to the legacy end-of-module hands on lab exercises. They are different than the Practice <task> inside the Learning Object. (The practice task will be explained later, but for now remember it as a non-hands-on activity).

Cleaning Your Framitz

This is an information object because it contains actual training content (not support for training). It is a task or procedural in nature. It should never contain any sub tasks. If this task needs sub tasks to support it, this prerequisite relationship gets expressed in the TD map by nesting a <topicref> inside another <topicref>. The Cleaning Your Framitz task is simply another task contributing to the objective of this Learning Object.

The context of this task, Cleaning Your Framitz, would be set here followed by the steps involved with the cleaning procedure. So you might say ... The Framitz is such an integral part of your equipment, and it is so vulnerable to harsh environmental conditions, that you should develop a habit of routine maintenance and cleaning.

Perform the following steps to clean your framitz:

  1. Identify the framitz you want to clean.
  2. Gather your framitz cleaning tools and supplies.
  3. Grasp your framitz in a secure place.
  4. and so on

Replacing FRUs and CRUs

This is another information object which contains training content that is task or procedural in nature.

The context of this task, Replacing FRUs and CRUs, would be set here followed by the steps involved with this procedure. For example ...

As you clean your framitz you may learn that some of its FRUs and CRUs need to be replaced.

Reusing Content

Although the new CMS system supports reuse of content at ant level, best practices indicates that reuse should be confined to just a few cases. These recommended cases are based on anticipated TD and topic repackaging scenarios.

There are three recommended levels or granularities for reuse, each serving a different purpose:

The highest or largest granularity level is used when courses or training deliverables are assembled.
This reuse activity assembles DITA topicgroups which are collections of Learning Objects into a course map (a slstdmap). This is analogous to assembling a legacy ILT course from a collection of legacy modules.
The middle level of reuse is the reuse of Learning Objects to form a topicgroup collection
This is analogous to assembling a legacy module from a pool of legacy enabling objectives.
The smallest level of granularity supports reuse of individual topics in the assembly of Learning Objects.
For example, part of this Learning Object you are now reading contains a number of component information objects. One that is below is the reference topic that contains a graphic. This lower level of reuse supports using that reference topic information object (table) in another Learning Object. The responsibility of the Course Developer when reusing at this level is to modify other components of the Learning Object to restablish its educational or instruction integrity. For example, if a new LO was created from another and some topics were added or dropped, the Overview or Assessment pieces may need to be modified accordingly.

It is important to emphasize that in order for something to be reused, it must standalone and make sense instructionally. Although by nature of its part in a larger assembly, it is related to its sibling components in the assembly, it must not strictly depend on anything outside of itself for it to be successful as a training component.

Reuse at the LO level and above should be to goal.

The High Level Course Structures

This is a DITA reference topic. References are typically figures or tables that you anticipate reusing often. It is just another information object contributing to the overall learning integrity of this Learning Object.

The figure shows the composition of the a training deliverable and its component learning objects. Notice that the <map> element bounds all the content of the training deliverable, or chunk, and should be 4 hours or less when delivered.

Figure 1. High Level Course DITA Structures The graphic shows how all the high level course structures relate
to each other.

Summary

This is a DITA concept or an SLS specialization of same. It supports the learning by summarizing the content of the entire Learning Object. OASIS DITA learning specialization is tending toward calling this a Summary.

The summary information for this Learning Object would be authored here.

Practice

This is another instructional object in support of the learning in this Learning Object. It is a set of paper-based exercises or activities that covers the content of the Learning Object and, as such, is not like a legacy end-of-module exercise. It is much smaller, maybe akin to a subset of the steps of a legacy end-of-module exercise but not in a hands-on environment. OASIS DITA learning specialization is tending toward calling this a Practice and so shall we to differentiate it from an exercise, the legacy end-of-module exercise that is outside any particular Learning Object. It is the hands-on activity requiring a lab environment. This larger exercise is referenced (using a topicref in the larger collection of Learning Objects in the <topicgroup> part of the course map. The activity it covers spans all the content of the Learning Objects of this topicgroup.

The context for this practice would be authored here, followed by the steps themselves. For example .. When you unexpectedly get called to a site to clean a framitz you might be caught without your full tool kit. To complete the job in this circumstance it is good to know the tools you absolutely cannot do without.
  1. Which of the following list of tools is indispensible for cleaning the framitz?
    • Alcohol swabs
    • Stainless steel brush
    • Antistatic spray
    If you selected both the swabs and the spray, you are correct.
  2. What quality grade is recommended for framitz lubricant?

Simulation

This is an optional instructional object, simulating the task procedures. It is a DITA concept or an SLS specialization of same.

The simulation itself would be authored here.

Demonstration

This is an optional instructional object, demonstrating some aspect of the LO's conteent.. It is a DITA task or an SLS specialization of same.

This is the context of the demonstration.

Assessment

This is a DITA task or an SLS Specialization of same. It is a required instructional object in support of the learning of this Learning Object. It contains assessment questions covering all the content of this Learning Objective.

Set a context for the assessment here and then author the assessment questions themselves. These assessment questions should only apply to this particular Learning Object.