ユニットをドラフトする
1つのユニットのリソースをドラフトします。COURSE-CANVAS.md、PLAN.md、PERSONAS.md、RESOURCES.md、DECISIONS.md、および前のユニットの資料を読み込みます。コースの既存のファイル構造(見出し、表、トーン)を使用してください。コースにまだ構造がない場合は、構造を提案し、確認を待ちます。
1. パスを先に書く
コンテンツの前に、まずユニットの学習者パスをセッションファイルのインストラクターノートに番号付きリストで書きます。学習者が参加者ページを開いてから成果物を提出するまでのすべてのステップを、それぞれ以下の情報とともに記述します。
- 必要なもの(概念、ツール、ファイル、リンク、アカウント)と、それがどこから来たか(前提知識、以前のユニット、このページ)
- 期待される結果(学習者が確認できるもの)
assumed-knowledgeを読み込みます。必要なものに由来がないステップはギャップです。ステップ、リンク、説明を追加して今すぐ解決するか、またはインストラクターに委ねます。パスを表示して確認を待ちます。これは資料が照合される仕様です。
2. ドラフト
RESOURCES.mdに従ってユニットに必要なものを、それぞれ適切な場所にドラフトします。
- インストラクター: タイミング、インプット、グループワーク、サンプル回答、ディスカッションポイントを含むセッションプラン。インプットブロックは、スピーカーノートを考慮したコンテンツ(主張、数字、例)として記述します。スライドは後で
/to-slidesによってこれらから作成されます。 - 参加者: 目標、タスク、成果物、長さを含む資料。
learner-instructionsを読み込みます。 - テンプレートまたはコード: タスクが依存するノートブック、データ、設定。
サンプル回答は、コースデータに対してコードを実行して計算します。記憶からは決して行いません。数字はどのように計算されたかを引用します。
3. 停止ポイント
ドラフトを表示し、自分が行った選択(タスクの文言、どのビデオを使用するか、どの程度オプションにするか)と、確信が持てなかった点を簡潔なリストで示します。インストラクターが編集または承認します。他のユニットに影響を与える選択はDECISIONS.mdに記録します。
インストラクターがドラフトを承認し、RESOURCES.mdにユニットがdraftとしてリストされたら完了です。セッションにインプットブロックがある場合は/to-slides <unit>、続けて/walk-through <unit>を提案します。このスキルでユニットをreleasedとマークすることは絶対にしません。