Manage myTrailhead Releases
After completing this unit, you’ll be able to:
- Explain how releases work.
- Describe the pitfalls of having two open releases.
The Pure Aloe myTrailhead team usually publishes one release a month. But if they want to publish more often (or less), they can. With Trailmaker Release, Marisol, the Pure Aloe release manager, can create and publish a release whenever she needs to.
The last unit noted that when Marisol creates a release, Trailmaker Release makes a behind-the-scenes duplicate of all the existing content on myTrailhead. When she publishes the release, Trailmaker Release overwrites the content on myTrailhead with what’s in the release: the duplicated content and the new and revised content. Let’s take a closer look at that process.
Marisol and Cindy, the myTrailhead writer, are working together to revise two trails: Sell Well at Pure Aloe, and Navigate Your Pure Aloe Career. The Sell Well trail contains two modules. The Navigate Your Career trail contains three.
||Sell Well at Pure Aloe
||Navigate Your Pure Aloe Career
For the Sell Well at Pure Aloe trail, Cindy is adding a new module, Pure Aloe Sales Goals.
For the Navigate Your Career trail, Cindy is removing the module Managing Up at Pure Aloe and making it a stand-alone module on myTrailhead.
How the Changes Happen
When Marisol creates the release for Cindy’s revisions, Trailmaker Release duplicates all of Pure Aloe’s existing myTrailhead content, including both trails and their existing modules. Then Cindy uploads her new and revised content from Trailmaker Content to the release. She uploads:
- The new Pure Aloe Sales Goals module
- The revised Sell Well at Pure Aloe trail, including the new module
- The revised Navigate Your Pure Aloe Career trail, excluding the module Managing Up at Pure Aloe
What the Published Changes Look Like
When Marisol publishes the release, she overwrites the existing content on myTrailhead with the duplicated content, plus Cindy’s changes.
Before Publishing the Release
After Publishing the Release
|Trail: Sell Well at Pure Aloe
||Trail: Sell Well at Pure Aloe
|Trail: Navigate Your Pure Aloe Career
||Trail: Navigate Your Pure Aloe Career
|Stand-alone module (no trail)
||Stand-alone module (no trail)
Marisol usually waits until she publishes her current release before she creates a new one. Creating one release at a time ensures that each release contains all of the most recent changes that she and Cindy have made to myTrailhead. In a pinch, Marisol can manage more than one open release at a time. But she prefers not to, and here’s why.
Last year, Marisol published a January release and then created a February release. When she created the February release, Trailmaker Release duplicated the existing content on myTrailhead, including the content from the January release. So far, so good.
Then Cindy discovered some errors in the January modules, and she wanted to correct them right away, before the next release came out in February.
“No problem,” Marisol told Cindy. “I can create a release called January Fixes, just for the corrections. We can publish this release now, before we publish the February one.”
And that’s exactly what Marisol did, much to Cindy’s relief.
Then Marisol realized that she had a problem with her February release. After she published January Fixes, the content on myTrailhead contained new changes that weren’t in the duplicate copy that Trailmaker Release had made for her February release. So, when she published the February release, she would overwrite Cindy’s corrections from January Fixes with the old, incorrect versions of those modules.
There was no way Marisol wanted to do that.
To avoid reintroducing the old content, Marisol added each module from the January Fixes release to the February release, too. When she published the February release, it included the corrections from January Fixes.
Marisol knows that she can use this trick in the future, if necessary. But to keep things tidy, she prefers sticking to one open release at a time.