myTrailhead コンテンツのトラブルシューティングと公開

学習の目的

この単元を完了すると、次のことができるようになります。

  • Trailmaker Release でリリースの健全性を確認できる場所について説明する。
  • Trailmaker Release のエラーと警告の違いを説明する。
  • Trailmaker Release でコンテンツを公開する方法を説明する。

Trailmaker Release の問題ページ

リリースプロセスを通して、さまざまな担当者からモジュール、バッジアート、グラフィック、ローカライズされたコンテンツなどが送られてくる中、Marisol はリリースの健全性に注意を払っています。公開を遅らせたり妨げたりする可能性のある問題に常に目を光らせています。 

問題があると、Trailmaker Release に警告やエラーが表示されます。リリースに警告やエラーが生じたら、Marisol はリリースページのアラートを確認します。

Trailmaker Release のリリースページ。エラーや警告のアラートが示されています。

アラートの [View Errors and Warnings (エラーと警告の表示)] をクリックすると、リリースの問題ページに移動し、警告とエラーがリスト表示されます。問題ページのモジュールまたはトレイルの下矢印をクリックすると、問題の説明を確認できます。

Trailmaker Release の問題ページ。リリースのエラーと警告が示されています。

警告とエラーは何が違うのでしょうか?

警告は、Marisol がリリースを公開する前に、Marisol や Cindy が修正したほうがよい問題を示します。ただし、これらの問題を修正しなくても、Marisol はコンテンツを公開できます。エラーがある場合は、Marisol がリリースを公開できません。

警告には次のようなものがあります。

  • モジュールに含まれる画像がファイアウォールの外側にあるため、myTrailhead がアクセスできない。
  • 単元に含まれる HTML コーディングを myTrailhead に表示するとコンテンツの書式設定がいびつになるため、Trailmaker Content でサポートされていない。
  • 画像に代替テキストがないため、デジタルスクリーンリーダーが視覚障害のあるユーザに対して画像を説明することができない。

エラーには次のようなものがあります。

  • リリースリストにモジュールまたはトレイルがあるが、コンテンツがリリースにアップロードされていない。
  • リリースリストの API 参照名が、別のコンテンツですでに使用されている。

Trailmaker Release の問題ページに問題が記載される前に、Trailmaker Content でも多くの問題が検出されます。このため、Cindy や Marisol が一定のエラーや警告を回避できます。たとえば、Cindy がコンテンツをリリースにアップロードしようとしているときに、モジュールにバッジアートが必要な場合、単元にテストが必要な場合、その他何らかの不備がある場合はウィンドウにアラートが示されます。 

Trailmaker Content のウィンドウ。モジュールをリリースにアップロードする前に、モジュールに追加すべき項目が示されています。

Cindy がこれらの問題を修正したら、コンテンツをリリースにアップロードできるようになります。

エラーや警告の修正

Marisol が Trailmaker Release でエラーや警告を見つけた場合、通常それらを修正可能であるのは Cindy です。Cindy は Trailmaker Content で修正を行ってから、モジュールまたはトレイルをもう一度リリースにアップロードします。Marisol は、Trailmaker Release の問題ページにエラーや警告が表示されなくなったかどうかを確認します。そして Cindy がプレビューモードでコンテンツをチェックして、問題のないことを確認します。

コンテンツの公開

リリースが公開可能な状態になると、Trailmaker Release のリリースページにアラートが示されます。 

Trailmaker Release のリリースページ。リリースにエラーや警告がなく、いつでも公開できることが示されています。

コンテンツの準備が整ったことを Cindy が確認したら、Marisol がすべきことは 1 つだけです。Trailmaker Release のリリースページで、[Publish (公開)] をクリックします。

Trailmaker Release のリリースページ。[Publish (公開)] ボタンが示されています。

Marisol にリリースの項目数と、警告数 (ある場合) を伝える確認画面が表示されます。リリースを公開する場合は [Let’s do this! (では始めましょう)] をクリックします。

Trailmaker Release の公開確認画面

これだけです。Marisol がボタンをクリックすれば、リリースのすべてのコンテンツが公開されます。次の画面で、今回公開したリリースが myTrailhead の最新リリースになったことが通知されます。

公開されたリリースが myTrailhead の最新リリースになったことを通知する、Trailmaker Release の画面

Marisol と Cindy は今回もやり遂げました。Pure Aloe の myTrailhead の内容を新しいコンテンツで更新し、既存のコンテンツが現在も正確かつ適切であることを確認しました。お互いにハイタッチし、今度の仕事もうまくいったとお祝いするのではないでしょうか。そして、同僚が myTrailhead に取り組んで、さらなるバッジを獲得し、新しいスキルを習得することでしょう。 

リソース