本頁針對 Google 系列文件接受的技術撰寫專案提供詳細資料。
專案摘要
- 開放原始碼機構：
- Oppia
- 技術文件撰寫者：
- atavar02
- 專案名稱：
- Oppia 新手指南：製作課程和相關教材
- 專案長度：
- 標準長度 (3 個月)
Project description
為什麼選擇 Oppia？
我過去曾經以老師的身分說明教育和學習，Oppia 的線上互動學習非常適合教師在引人入勝的學習環境中發揮創意，與學生聯絡，並讓世界各地的學習者取得這些資源。我願意參與本網站的說明文件，成為這個全球社群的一分子。
為什麼是這個專案？
隨著線上學習在世界各地越來越受歡迎，現在也必須打造容易使用及管理的平台，而不只是對學生的需求，還有家教。Oppia 是這類互動式學習平台，致力於在線上以引人入勝的方式，重現一對一學習情境。Oppia 這類平台的成功關鍵，在於教育服務供應商能建立有效的學習單元或「探索」，促進互動、對話和意見回饋。教師的角色不會就此結束，課程發布後，還可根據學生的互動情形和意見回饋進一步改善探索。
同時根據這些需求製作 Oppia 新手指南，將我的技術寫作技巧與我熱愛的知識主題結合，是絕佳做法。我剛取得了技術通訊認證，負責研究高度著重使用者體驗、數位媒體和資訊架構的專案，而這個專案也能讓我運用在計畫中學到的技巧。
專案計畫與實作
原因
Oppia 的教育提供者需要清楚且易於使用的工具和資訊才能建立探索，這時只要提供詳盡的說明文件就能派上用場。他們也必須瞭解更複雜的探索改善工作。使用簡單明瞭的文件可以提供良好的使用者體驗。
由於使用者的學習方式各不相同，因此建議提供書面指南和影片教學課程。影片教學課程具有視覺學習者的特色，而且影片將是針對特定任務製作，因此使用者能快速獲得所需資訊。
目標對象分析
這項專案的目標對像是指想建立探索或學習單元的使用者。使用者是指對教學感興趣的任何人，包括班級老師、家教、退休人士、想分享自身經驗和知識的學生、想教導他人的學生、志工、教授等。這些不同使用者會在 Oppia 執行的工作，取決於自己的職務和想向 Oppia 達成的目標。與想向同儕解釋困難概念的學生相比，符合資格的老師可能會想建立更全面的探索報告。
使用者則擁有多種技能，從新手到各領域的專家都沒問題。這個專案的重點在於提供逐步拓展知識的指南，也就是引導較複雜的工作，因此採用這些指南的小組最為中級和專家。因此，指南應考量到這個範圍，並為專家提供快速路徑資訊。
專業知識等級：中級
概念：需要瞭解更複雜的概念，例如規則、特性等。
Tasks：適合執行更複雜的任務，例如加入旁白、圖片、在探索中加入分支等等。先前已經建立了教案，但不一定是 Oppia 上的互動式計畫。
參考資料：這個群組需要大量文件。
專業知識等級：專家
概念：需要瞭解參數、嵌入等更進階的概念。
任務：需要學習如何將教學專業知識與 Oppia 配對，如果他們已經認識 Oppia，也要找出是否有任何新任務。這個群組也對複雜的工作有興趣，例如有效使用「記錄」或「統計資料」分頁。
參考資料：曾與 Oppia 合作，或是熟悉類似的學習平台。具備專業教學知識，以及建立有效的教案。這個小組需要用到最少的文件。
使用者工作分析
規劃探索：
- 建立故事大綱
- 在輪廓上規劃探索
- 規劃評估方法
例如：尼爾是首度使用奧帕亞的老師。開始在奧帕西亞工作前，Neil 必須規劃這次探索的學習成果或目標。接著，他必須思考一個引人入勝的情境，以建立課程。這有助於培養學生的興趣。
規劃探索廣告活動時，阿尼會記得先以簡單的線性探索開始，因為他知道自己之後可以複雜許多心力。他思考如何呈現說明和測試學生的學習狀況。根據學員的回覆，Neil 必須思考如何呈現意見回饋，並在探索過程中深入探索。
大致瞭解研究目的後，Neil 就能開始在奧皮亞工作。
在課程中加入旁白 (透過「翻譯」分頁)：Neil 還可以在資訊卡中加入旁白，或將其翻譯成其他語言。如果他想加入其他語言的旁白，小尼必須先將資訊卡翻譯成該語言，才能加入旁白。
使用「記錄」分頁：他可以透過「記錄」分頁將探索還原為較舊的已儲存版本，在這個分頁中，小尼也可以下載並儲存較舊版本。
使用意見回饋分頁：學生可隨時在探索過程中提供意見回饋。小尼可以參考這些意見回饋，並根據結果調整課程內容。他可以回覆訊息，並提供多種變更訊息狀態的選項 (已修正、無法採取行動等)
透過統計資料和遊戲過程 (使用「統計資料」分頁) 提升課程內容：Neil 發布探索內容，並讓不同的學生正在學習時，會希望運用學生的互動情形來改善他們的探索體驗。他有幾個方法能提升課程品質。
他可以開始建立支線，最終引導回先前建立的主要分支版本，以增加探索的複雜度。他可以為進階學習者提供捷徑，避免無聊並提高他們的參與度。他可以考慮使用參數，針對特定遊戲過程的特定學員自訂探索。
新增圖片、影片：阿尼還可以在製作特定資訊卡時加入圖片、影片和連結。
邀請其他使用者加入探索：阿尼可以邀請其他使用者加入探索，並為他們指派下列不同角色：
- 管理員
- 協作者
- 譯者
- 遊戲測試人員
每個角色皆可控管其下層角色的功能，因此「管理員角色」具備最豐富的功能。由於尼爾建立了這項探索報表，他將擔任奧佩尼亞的「管理員」角色。
建議指南 (根據使用者工作分析)
規劃課程
- 建立故事大綱 / 情境
- 建構情境式課程
- 規劃評量方法 (包括如何寫練習題)
在課程中加入旁白 (透過「翻譯」分頁)
- 以原始課程語言加入旁白
新增其他語言的旁白
- 翻譯資訊卡中的文字 *錄製第二種語言的旁白
有效使用「統計資料」、「記錄」和「意見回饋」分頁
以圖片、影片和連結等格式呈現課程內容
運用統計資料和遊戲過程強化課程內容
- 在現有課程中新增分支
- 為進階學習者建立捷徑
邀請其他使用者加入課程 (角色)
- 角色類型及其階層
導入作業
做法：
Oppia 的說明文件結合了書面指南和影片教學課程 (範例請見下方的「範例指南」一節)。這種做法能滿足不同的學習方式，並提供更多選項，讓使用者瞭解 Oppia 的運作方式。
規劃：
專案包括使用手冊和影片教學課程。指南和影片涵蓋上方「建議的指南」部分中詳述的內容，但例外 (第一個「規劃課程」指南不需要影片)。影片會嵌入在使用者工作的網頁中。
每週里程碑：
開發階段於 2019 年 9 月 2 日至 11 月 22 日。
第 1 週、第 2 週、第 3 週 (9 月 2 日至 20 日)：
規劃課程 (建立故事大綱 / 情境、規劃情境式課程、規劃評量方法 (包括如何寫出練習題)
第 4 週 (9 月 23 日到 27 日)：
在課程中加入旁白
第 5 週、第 6 週、第 7 週 (9 月 20 日至 10 月 18 日)：
有效使用「統計資料」、「記錄」和「意見回饋」分頁
第 8 週 (10 月 21 日到 25 日)：
以圖片、影片、連結等格式呈現課程內容的格式 邀請其他使用者加入課程 (角色)
第 9 週、10 天和 11 週 (10 月 28 日 - 11 月 15 日)：
運用統計資料和遊戲過程強化課程內容
第 12 週 (11 月 18 日 - 22 日)：
檢查及修改
範例指南和影片教學課程
https://audstav.github.io/oppiasampleguide/
平台
建議繼續使用 Oppia 目前代管說明文件的 GitHub 頁面。GitHub 不允許嵌入影片，因此只能按照上方範例指南所示插入影片連結圖片。
其他承諾使用合約
在本專案的實作階段，我將位於東部夏令時間 (EDT) 區。我還能參與整個專案期間，也就是到 11 月結束。
通訊
聯絡頻率取決於導師的討論內容。我偏好定期交流，我建議每兩週一次告知最新消息，並接收目前為止完成作業的意見。但是這可以隨導師的偏好彈性調整。