How courses, lessons & training fit together

Namaste Salesforce has two closely related ways to package structured learning — courses and training roadmaps — plus the lessons that make them up. Understanding when to use each, and how they are wired with tags, is the key to authoring effectively.

A course is a single, self-contained subject: "Apex Masterclass", "LWC A-Z". Mechanically, a course is one post carrying the internal #course tag, whose slug equals its public course tag. Its lessons are separate posts carrying #lesson, each with the course's public tag as its primary tag. That shared primary tag is what makes lessons nest under the course at /courses/{course-tag}/{lesson-slug}/.

A training roadmap (or track) is bigger: a multi-section journey like the "Admin Roadmap", broken into curriculum sections. A track is a post tagged #training whose slug equals its track tag. Each section lesson is a post tagged #training-content whose primary tag is the track tag (so it nests under the track), plus a secondary public section tag (train-{track}-NN-*) used only to group lessons into sections in the curriculum view.

COURSE                              TRAINING TRACK
------                              --------------
post #course                        post #training
  slug == course tag                  slug == track tag
lesson posts #lesson                section-lesson posts #training-content
  primary = course tag                primary = TRACK tag  (nests under track)
                                      secondary = section tag (groups in curriculum)

So the practical rule is: reach for a course when the material is one cohesive topic, and a training roadmap when it is a long, multi-stage path with distinct phases. Both are ordered the same way — by published date, ascending — which the next doc and the Authoring section cover in depth.

Everything else (levels, durations, hero layouts, free vs paid) is layered on with internal tags without changing this core structure. Once you have this model in your head, the authoring docs are mostly about which tags to apply.