コーススタイル

この記事では、コースコンテンツにのみ適用されるルールについて説明します。具体的には、コースと特集記事を区別する要素、コースとモジュールの構成、命名規則、レッスンと演習のパターン、学習目標、評価、コース固有の視覚的規則、コース固有の用語などです。 共通のルールについては、 コアスタイル および 書式設定 を参照してください。 製品ドキュメントについては、 ドキュメントスタイル を参照してください。

コース内容を特徴づけるもの

コースの内容は、機能ドキュメントとは以下の3つの点で異なります。 すべてのコースは、これら3つの要素を取り入れ、重点的に取り組まなければなりません。これらの要素のいずれかが欠けているコースは、単なる機能説明資料に成り下がってしまっています。

• ベストプラクティス: Liferay の機能の選択と使用に関する明確で意見のあるガイダンスを提供します。 レッスンでは、推奨事項を提示し、ベストプラクティスを強調し、よくある落とし穴について注意を促すべきである。
• ストーリー: 現実的なユースケースを中心にレッスンと演習を構成します。 レッスンでは、Liferayの機能とベストプラクティスをユースケースに適用し、演習を通して学習者が実際に実装を行う手順をガイドします。
• ビジネス価値: モジュールのレッスンと演習では、 Liferay 機能の実用的な利点を 実証する必要があり、単に 主張するだけでは いけません。 ビジネス価値を一度か二度述べるのは構わないが、その後はコンテンツでそれを証明する必要がある。

Clarity Vision Solutionsの事例研究

本コースの内容では、Clarity Vision Solutionsを事例研究として取り上げています。 Clarityは架空の企業であり、すべてのコースに一貫した物語の骨子を与えています。つまり、同じ登場人物、同じビジネス上の問題、同じソリューションアーキテクチャが、コースで扱うLiferayの機能に適用されるのです。

コース全体を通して、実例が必要な箇所ではすべてClarityを活用してください。

• 導入部分は必ず最後にClarityの事例研究へと繋がる。
• レッスンでは、教材をClarity社のビジネス目標と課題に結びつけて説明します。
• 演習は、 の に対するソリューションの実装を学習者にガイドします。抽象的なユーザー向けではありません。
• 知識確認テストとバッジテストは概念に焦点を当てています。明確化に特化したシナリオは、評価ではなく、レッスンや演習の文章中に登場します。

コース構成

すべてのコースは、同じトップレベルの構造を持っています。

• はじめに: 学習者を歓迎し、コースの目的を述べ、対象者 (開発者、ビジネスユーザー、管理者など) を特定し、前提条件を述べ、学習目標の概要を示します。
• Clarity の始め方: ケーススタディを紹介します。Clarity のストーリー、目標、課題、そしてこのコースで取り上げる重要な成功要因について説明します。
• コース環境設定: ソフトウェアのインストール、設定の構成、コース固有のリソースへのアクセスに関する手順を段階的に説明します。 2つのバージョンがあります。1つはビジネスユーザー向け、もう1つは開発者向けです。 コースの対象者に合ったバージョンを使用してください。 コースでGitHubリポジトリが必要ない場合は、この記事は省略してください。
• モジュール: 整理された学習コンテンツ。 モジュール構造 を参照してください。 基礎 コースではモジュール区分は使用されません。
• 結論: コースの重要なポイントを要約し、関連する Liferay Learn リソースへのリンクを示します。
• バッジテスト: コースの概念とベストプラクティスの定着度を評価する最終テスト。

モジュール構造

コースモジュールは、コースを構成する主要な要素です。 それぞれが特定のユースケースや技術的なトピックに特化しており、単一の製品機能に特化することはありません。 すべてのモジュールは次のような構造になっています。

• 概要: トピックを設定し、モジュールの学習目標を列挙する簡潔な導入。
• レッスン: 資料を Clarity のストーリーに関連付け、Liferay 機能のビジネス価値を強調し、ベストプラクティスを推進します。 3つのレッスンパターンについては、 レッスン を参照してください。
• デモ: 主要な概念とベストプラクティスを示す短いビデオ。 （現時点では、デモは対面式トレーニング向けですが、将来的にはオンラインコースの動画として提供される予定です。）
• 演習: 学習者が学んだことを応用する、ガイド付きの実践的なアクティビティ。 演習 を参照してください。
• 知識確認: モジュールの重要なポイントを再確認するための 5 問のクイズ。 評価を参照してください。

組織原則

原則 機能ではなくユーザーの目標で整理する は コアスタイル に含まれています。これはドキュメントにも適用されますが、特にコースにとって重要です。 ハッピーパスファーストにも同様にコアで適用されます。 以下の原則は、各コース固有のものです。

共通の考慮事項を統合する

いくつかのトピックはベストプラクティスに不可欠であり、個別のモジュールとして扱うのではなく、レッスンに直接組み込むべきである。

• トラブルシューティング: 学習者がモジュールのトピックに関連する一般的な問題を特定して解決するための知識を身につけます。
• パフォーマンス: レッスン全体を通してパフォーマンスに関する考慮事項を取り上げ、学習者がスピードと効率を最適化する方法を指導します。
• テスト: 適切な場合は、テストが不可欠であることを推奨し、対象となるトピックのテストの実施方法に関するガイダンスを提供します。
• セキュリティ: 学習者が安全なソリューションを構築する方法を理解できるように、セキュリティに関する考慮事項をすべてのモジュールに統合します。

自然な区分に従う

効果的なモジュール構成は、ユースケースや技術トピック内の自然な区分に従う。

• 個別の部分を特定します: ユースケースを主要なコンポーネントまたはステージに分解します。
• 順序依存性を認識する: 概念的に（学習者が理解する必要があること）と実践的に（他の手順の前に完了しなければならない実装手順）何が最初に必要かを特定する。

これがうまくいけば、学習者は個々の手順を習得しながら、全体のプロセスを理解することができる。

命名規則

一貫性のある命名規則は、学習者がコースの階層構造を理解しやすくするのに役立ちます。 タイトルは、幅広いトピック（モジュール）と、具体的な行動や概念（レッスンや演習）を区別する役割を果たします。

モジュール

モジュールのタイトルは、包括的なトピック、ビジネスニーズ、または機能を表しています。 これらは名詞句であり、動作、動名詞、またはLiferayの機能名ではありません。

• フォーマット: [名詞句 / トピック]
• 例: コンテンツ管理の基礎、 サイトスタイリング、 プロセス自動化、 データモデリング。

レッスン

レッスンのタイトルは、大きく3つのパターンに分類されます。 それぞれ動名詞で始まり、特定のタスクに焦点を当てています。

• レッスンの理解 モジュールのトピックの基本的な概念と原則を探求します。 これらは常に 理解 (例: 理解 Liferay オブジェクト ) から始まります。
• 戦略的教訓 では、モジュールのトピックに関する戦略的考慮事項とアーキテクチャ上の決定について探究します。 それらは常に の決定 (例: 効果的なコンテンツ管理戦略の決定 ) で始まります。
• ユースケース レッスン は、モジュールのトピック内の特定のタスクまたはユースケースに焦点を当てます。 これらは記述的な動名詞を使用します（例： ページレイアウトの構造化）。

演習

演習記事には、学習者がレッスンで学んだ概念をClarityに適用する実践的なアクティビティが含まれています。 それらは動名詞で始まり、ストーリーテリングの骨格を強化するために、タイトルに必ず Clarity が含まれます。

• 形式: [動名詞] + Clarity の + [目的語] または [動名詞] + [目的語] + Clarity 用
• 例: Clarity の倉庫の設定、 Clarity のプロモーションの設定。

命名例

コンポーネント	Bad	Good
モジュール	サイトのデザイン / アクセシビリティを考慮したデザイン	サイトデザイン / アクセシビリティ
レッスン（理解）	フラグメントとは何ですか？	ページ要素の理解 / サイトスタイルの理解
レッスン（戦略）	デザイン戦略	サイト設計戦略の決定
レッスン（ユースケース）	レイアウトフラグメントの使用	ページレイアウトの構成
演習問題	カスタムテーマの作成	スタイリング・クラリティのウェブサイト

コースレベルのコンテンツ

コース紹介

コース紹介では、読者の興味を引きつけ、以下の4つの質問に答えます。

• なぜこのコースを受講すべきなのでしょうか？ その話題がビジネス成果にどのように関連するかを伝えることで、関心を喚起する。
• このコースは誰のためのものですか？ 対象となるユーザー層（開発者、ビジネスユーザー、管理者）を明確に特定する。
• 前提条件は何ですか？ 必要な事前履修科目、知識、またはスキルを列挙してください。
• 何を学びますか？ 学習目標を提示します。

導入部の最後は必ずClarityの事例研究へと繋げるようにしてください。 この例 を参照してください。

Clarity を使い始める

Clarity 入門 の記事では、ケーススタディを紹介しています。 内容は以下の通りです。

• Clarity Vision Solutionsの簡単なご紹介です。
• Clarityが解決しようとしている問題点についての説明。
• 成功に不可欠な要素を一覧にし、それらに対応するLiferayの機能について簡単に説明します。
• コースの解答例の説明。レッスンではこの解答例が参照され、演習ではこの解答例が用いられます。

この内容は簡潔かつ要点を絞って記述してください。 この例 を参照してください。

モジュール紹介

モジュールの紹介では、モジュールのトピックを簡潔に説明し、これまでに学んだ内容と今後の新たな課題との橋渡しをします。 構成は2つの段落と学習目標のリストです。

• 段落 1: モジュールのトピックのビジネス価値を表現し、主要な要件または課題を簡潔に述べ、Liferay がそれらを満たすためのツールをどのように提供するかを結論付けます。
• モジュールバナー: モジュールバナー画像を段落の間に挿入します。
• 段落 2: 学習者がこれまでに学習した内容を簡単に要約し (「これまでに学習した内容は…"」)、現在のモジュールで学習する内容を述べます (「このモジュールでは、学習した内容は…"」)。
• 学習目標: モジュールに適用される 学習目標のリスト。
• 結論への移行: 学習者を最初のレッスンのトピックに誘導します（「まずは…を探求することから始めます」）。

この例 を参照してください。

学習目標

各コースおよびモジュールの開始時に学習目標を提示してください。 目標は、学生が習得すべき知識と技能を明確に示すものである。 以下のパターンに従ってください。

このコースを修了するまでに、あなたは以下の知識とスキルを身につけます。

• 【学習目標を挿入】

目標が具体的で、測定可能で、達成可能で、関連性があり、期限が定められていることを確認してください（ SMART ガイドラインに従って）。 この例 を参照してください。

レッスン

授業は概念的な基礎を提供する。 彼らは、Liferayの機能の仕組みと論理を説明するとともに、業界のベストプラクティスを強調し、Clarityを使用して実際のビジネス価値を実証します。 レッスンでは、学習者が実践的な作業に進む前に、自分の行動の 理由 を理解できるようにします。

教訓を理解する

これらのレッスンでは、機能とは何か、そのアーキテクチャ、そしてLiferayにおけるその役割といった、基本的な概念と機能を紹介します。 例: Liferay の Commerce 機能の理解、 注文と注文タイプの理解、 プロモーションと割引の理解。

ユースケースから得られる教訓

これらのレッスンでは、戦略的かつ現実的な実装方法、つまり特定のビジネス課題を解決するために機能をどのように組み合わせるかに焦点を当てています。 例: コマース実装戦略の決定、 コマースユーザーの管理、 ストアフロントの構築。

レッスンの構成

• レッスンの紹介: 最大1段落。 次の4つの重要な要素を含めてください。トピックに関連する明確なビジネス目標（例：営業担当者が顧客にサービスを提供できるようにする）、関連する要件（営業担当者チームを編成する方法）、目標に対応する主要なLiferayツール（組織）、およびこれらのツールを使用するメリット（セキュリティと拡張性のためのアクセス制御の効率化）。 導入段落の後に、レッスンの焦点を述べる独立した文を続けて記述します（「このレッスンでは、…"）。
• 本体: [作業中 — スタイルが成熟するにつれて下書きされます。]
• 明瞭性アプリケーション: [作業中]
• 結論: [作業中]

演習

演習 の記事では、学習者はモジュールのレッスンの概念を適用します。 各演習記事には、1つまたは複数の個別の演習が含まれる場合があります。 各演習の目標は、学習者がClarityの特定のビジネス課題を解決する際に、ベストプラクティスに従うことです。

記事の構成

• 一般的な紹介: 最大1段落。 最初の文は、このテーマの戦略的重要性について述べている。 次の1、2文で、話題をClarityの事例研究に結びつけます。 最後の文は、演習の全体的な目標を述べています（「これらの演習では、あなたは…」）。

• 個別演習: それぞれが H2 セクションであり、タイトルは 演習: [タイトル] です。

  • 練習問題の紹介: 2、3文。 必ず最後に、その演習に関するメタコメント（「ここでは、[ペルソナ]として[具体的なタスク]を行います。」）を添えてください。
  • 手順: 最初の演習では、ペルソナを指定し、資格情報を提供します。 直接的で命令的なコマンド（「クリック」、「エンター」、「確認」など）を使用してください。 初めて手順を説明する際は、明確かつ詳細に説明し、繰り返し行う作業については簡潔に説明してください。 重要な手順の後には、目的や結果を説明する簡潔で邪魔にならない文を1、2文追加してください（「これにより…が保証されます」）。 必要に応じて、学習者に自分の行動の結果を確認するよう促してください。
  • 演習の結論: 学習者の達成度を記録します (「素晴らしい！」 あなたは…") を達成し、あまり具体的に説明せずに次のエクササイズ ("今度は…") をジェスチャーで示します。

• 全体的な結論: 約3文。 トピックの戦略的重要性を改めて述べ、学習者が Clarity で達成したことを簡潔に要約し、成功の鍵を指摘し、標準的な 次に、… 移行文で締めくくります。

運動の原則

• 集中力を維持する: 各エクササイズは、1 つの主要な目標を達成します。
• 理想的な手順: 学習者が初めて新しいタスクを実行する場合、その演習は最もシンプルで推奨されるプロセスを通して学習者を導く必要があります。 （コアの ハッピーパスファースト を参照してください。）
• 目的主導型のアクション: すべてのクリック、コマンド、および設定は、Clarity 用に定義された特定のビジネス問題を解決するための論理的かつ必要なステップでなければなりません。 余計な手順は一切あってはならない。目標に直接貢献しない行動は排除すべきである。
• 精度: エクササイズは取扱説明書です。 その文言は正確でなければならず、曖昧さを避ける必要がある（曖昧な表現や言い回しは許されない）。

記事の遷移

記事の序論と結論は、コース全体を繋ぐ役割を果たします。

序文は読者の興味を引きつけ、背景を明確にするものであるべきだ。 学習者が記事の合間に時間を置いていたと仮定しても、すべてを要約する必要はありません。 明瞭さについて言及する。 材料は流れるべきである。

結論は2～5文で記述してください。 最初の文は記事の要点を要約し（簡潔な要約）、最後の文は学習者が次にどこへ進むのかを予測する。 このパターンを使用してください：

次に、[次の記事のトピック]についてお話しします。

知識チェックに移行する際：

次に、次のモジュールに進む前に、これまでに学習した内容を復習します。

結論を出す前に知識確認に移行する場合：

次に、コースを修了する前に、これまでに学んだ内容を復習します。

コースのまとめ

どのコースにも、最終バッジテストの前にまとめ記事が用意されています。 このテンプレートを使用してください：

これで、 [コース名]コースを無事修了しました。

【コースのテーマと重要なポイントについての簡単な説明。】

このコースを受講することで、以下の知識とスキルを身につけることができます。

• [コースの学習目標を列挙してください。]

関連情報

[コーストピック]についてさらに学習するには、以下のコースを受講することを検討してください。

• [学習パス内の他のコースへのリンク]

次に、コーステストを完了してバッジを獲得しましょう！

評価

評価は、学習者がコンテンツを消費しただけでなく、それを記憶し習得したことを検証するものです。 3つの階層があります。

比較

機能	知識チェック	バッジテスト	認定試験
主な目的	主要な概念を確認し、 モジュール の概念の基本的な理解を検証します。	主要な コースの 概念の保持と理解を確実にします。	役割に基づいた知識とスキル（コンテンツマネージャー、Liferayアプリケーション開発者など）の習熟度を証明する。
プラットフォーム	LMSを学ぶ	LMSを学ぶ	ウェブアセッサー
質問数	5	20+	50歳以上（250人以上の候補者の中から選出）
難度	低～中程度	中	中程度～高
結果	記録されません。進行を妨げません。	録画済み。コースバッジ取得に必須。	記録済み。公式のLiferay認定資格が付与されます。
リトライ回数	無制限	無制限	限定

知識チェック

知識確認テストは、コースモジュールの最後に実施する、リスクの低い復習ツールです。 学習者が次のモジュールに進む前に、その内容を理解していることを確認する。 各知識確認テストは、モジュールの重要なポイントに焦点を当てた5つの質問で構成されています。

起草の原則：

• 直接的で明確: 曖昧さがないこと。巧妙な構文を避けること。
• レッスンベース: すべての回答はモジュールのレッスン内に明示的に記載されています。
• 概念重視: 重要な定義、区別、およびベストプラクティスに焦点を当てます。 Clarity特有のシナリオは避けてください。
• 用語の一貫性： 記憶の定着を助けるために、レッスンで使用した用語と表現をそのまま再利用します。

知識確認テストは、Liferay Learn LMSで作成および管理されます。 知識チェックの作成 を参照してください。

バッジテスト

バッジテストは、学習者がコース全体を通して最も重要な要点を習得したことを検証するものです。 これらは包括的な内容であり、コースのバッジを取得するために必須です。 各バッジテストは20問以上の問題で構成されている必要があります。

バッジテストの問題は、知識チェックとほとんどの原則を共有していますが、以下の例外があります。

• 包括的な範囲: 質問をすべてのコースモジュールに分散します。
• 優先順位付け: コースを完了するために不可欠だった大局的な概念と戦略的なベストプラクティスを優先します。
• 中程度の難易度: 正解があまりにも明白でないことを確認してください。 単なる定義にとどまらず、特定のシナリオに適したツールや構成を特定する必要のある質問を含めるようにしてください。

バッジテストは、Liferay Learn LMSで作成および管理されます。 バッジテストの作成 を参照してください。

認定試験

認定試験は、役割に基づいた知識とスキルの専門的な習熟度を証明する、非常に重要な評価です。 これらは Webassessorで作成、管理、運営され、各試験は 250 問以上の大きな問題プールから 50 問以上を抽出して動的に生成されます。

起草の原則：

• アプリケーション中心: 特定のシナリオに知識を適用する必要があるユースケースの質問を優先します。
• 検索耐性: 簡単に調べられる、定義に基づいた単純な質問を最小限に抑えます。
• 物語中立: Clarity を参照しないでください。 広く適用できる、一般的で専門的なシナリオを使用してください。

質問の種類

理解度の異なるレベルを評価するために、主に4種類の質問形式が用いられます。

• 定義: Liferay の用語または機能の意味を学習者に特定させることで、基本的な理解度をテストします。
• カテゴリ: 学習者に機能や関係に基づいて機能や概念をグループ化するように求めます (たとえば、クライアント拡張機能の種類を区別する)。
• ベストプラクティス: Liferay の実装を規定する原則と標準に焦点を当てます。 単なる機能的な可能性よりも、推奨される建築的または手続き上の規則を重視する。
• ユースケース/アプリケーション: シナリオ内でビジネスまたは技術的な要件を提示し、学習者は分析して適切な実装を選択します。 最高位の資格。認定の主な対象。

この表を使用して、どの問題形式がどの評価に属するかを判断してください。

質問の種類	知識チェック	バッジテスト	認定試験
定義	メインにする	セカンダリ	第 3
カテゴリ	メインにする	メインにする	セカンダリ
ベストプラクティス	メインにする	メインにする	メインにする
ユースケース／アプリケーション	避ける	避ける	メインにする

問題の難易度を管理する

問題の真の難易度は、選択肢の妥当性によって決まる。 問題の難易度は、最も説得力のある選択肢（誤った答え）の数によって決まる。

• 知識チェック: 誤答は正解と明確に区別されます。 レッスンを読んだ人なら誰でも、自信を持って正解を特定できるはずだ。
• バッジテスト: よくある誤解や類似の (ただし間違った) Liferay 機能を表す、より微妙な紛らわしい選択肢。 学習者は、馴染みのある用語を認識するだけでなく、関連する概念を区別する必要がある。
• 認定試験: 機能的ではあるが最適ではない解決策を表す、非常に説得力のある選択肢。 正解は、与えられたシナリオにおいてLiferayのベストプラクティスに厳密に準拠している唯一の選択肢です。

どのレベルであっても、明らかにばかげた、いい加減な回答は避けてください。

ビジュアル

共有画像、代替テキスト、図、スクリーンショットのガイダンスについては、 書式設定 を参照してください。 以下の規則は、特にコースに適用されます。

図表と装飾デザイン

デザインチームは、コース固有のグラフィック（図表、コースバナー、モジュールバナー、バッジなど）を作成します。 図は、抽象的な概念、高レベルのアーキテクチャ、またはバックエンドプロセスを表します。 装飾要素（バナー、バッジ）は、視覚的なアイデンティティと節目を示す目印となる。 既存のコース図については、 ブランドポータル を参照してください。

デザインの依頼

Jira オートメーション は、 新しいコース 用に DESIGN エピックと標準バナー/バッジ チケットを自動的に作成します。 コースメンテナンスについては、DESIGN エピックを手動で作成してください。

• 早期に開始する: デザインのニーズを認識したらすぐにデザインチケットを開きます。
• 新しいコースのエピック: コース: [コース名]
• メンテナンスエピック: [コース名] の 2026 年第 1 四半期グラフィックデザインの更新
• 個別リクエスト: [設計タイプ]: [簡単な説明] (例: 図: チームベース開発)。
• 期日を合わせる: DESIGN チケットの期日が、対応する ENBT チケットの期日と一致していることを確認します。
• 既存のデザインの更新: コースの DESIGN エピックで新しいチケットを作成し、説明に元のデザイン チケットを参照します。

詳細については、 社内デザインプロセス を参照してください。

スクリーンショット

スクリーンショットを使用する場面：

• まず、主要なUI要素またはアプリケーションを紹介します。
• 学習者は、複雑または分かりにくい演習手順を完了しようとしています。
• 学習者は重要な演習チェックポイントに到達します。
• 学習者は演習を完了し、その成功を確認する必要があります。

スクリーンショットは、学習者が先に進む前に、自分が正しい方向に進んでいるかどうかを確認するのに役立ちます。 それらを慎重に使用し、周囲のテキストを覆い隠さないようにし、それらが引き起こすメンテナンスの手間を考慮してください。

単一のアプリケーションに対して複数のユーザーインターフェースを表示する必要がある場合、または複数ステップのプロセスを最終結果に視覚的に関連付ける必要がある場合は、スクリーンショットのコラージュを使用してください。

マークアップ

マークアップを使用して、学習者の視線を特定のUI要素に誘導します。

• 色: #FFC10C すべてのスクリーンショットのマークアップ用。
• ボックス: 読者の注意を特定の UI 要素に集中させます。
• 矢印: 要素間の関係やシーケンスを視覚化します。
• 番号: 複数の要素が識別される UI 参照画像に使用されます。 関連するレッスンや練習問題のテキストの中で、数字と説明を対応させなさい。

額装

• コンテキストを提供します: 学習者が方向感覚を失うほどきつくトリミングしないでください。
• フォーカスを維持する: ノイズを除去する。 無関係なUI領域を含む全画面表示や無差別なブラウザスクリーンショットは避けてください。
• 視線を誘導します: 標準化されたマークアップカラー (#FFC10C) を使用して、議論されている特定の UI 要素に注意を向けます。

UIアイコン

可能な限り、手動で切り抜くのではなく、標準化されたUIアイコンセットを使用してください。

• 標準の手順： Lexicon IconsのFigmaからUIアイコンをPNG形式でエクスポートします。
• 例外: Figma に必要な色が含まれていない場合は、アイコンの高画質スクリーンショットを使用してください。
• アセット共有: 一貫性を保つため、全員が同じアイコン画像を使用します。

慣用句

コース特有の専門用語。 すべてのコンテンツに適用される共通のフレーズ規則については、 コアスタイル を参照してください。

「～のために設計された」

機能が何をするのかを直接的に述べる（「オブジェクトはカスタムデータを保存します」であって、「オブジェクトはカスタムデータを保存するように設計されています」ではない）。 レッスンの目標が、 なぜ 機能が存在するのかを教えることである場合、目的フレームを使用できます。 はのために設計されています、 はを意図しています、 は のために構築されています。目的自体が教えるポイントだからです。 基本的には直接的な表現を用い、目的を明確にする表現は必要な場合にのみ用いる。