Training modules/Design ideas/ja

This page is a translated version of the page Training modules/Design ideas and the translation is 35% complete.
Overall goals
Drafting/discussion spaces
Discuss design, accessibility, and formatting of modules

ウィキメディア財団では学習モジュール(training modules)を作成し、お役に立つ内容を使い勝手の良い設計で提供するように努めています。そこで以下のモジュールの作成を手がけたところ、こうするべき というだけでは不十分なことに気づきました。考慮すべき点とは、それをどのように 示すか、構成はどうなるのか、それらのモジュールで学んでみようとする学習者がモジュールとどう出会い、使うつもりか。以下にモジュールの設計試案と、今後の検討課題となる設計要素を示します。

これら設計の課題について、皆さんのご意見を募集中です。以下に投稿をご検討ください。 トークページ.





The TrainingPages module was originally designed by user:Ragesoss (then working as a Wikimedia Foundation contractor as User:Sage Ross (WMF), now continuing his work as part of the Wiki Education Foundation as User:Sage (Wiki Ed)) to be used by participants in the Education Program. TrainingPages provides a set of wrapper and navigation templates that (semi-)automatically format educational content into ordered lessons.



  • Does not require advanced programming knowledge, just advanced knowledge of wikimarkup and templates
  • Runs natively on-wiki, including translations
  • Many good examples using this module already exist, courtesy of the EP
  • Very user-friendly for module users; simply click "next" and "previous", etc
  • Displays users' progress ("you are on page 1 of 15") to them
  • Works on mobile


  • Complex system of templates that this relies on means it must be set up (and updated, when needed) by an experienced, template-fluent user
  • Any "tests" or user exercises that require the to edit or be graded on an answer will take place outside of the Training Pages (pages in the module can give directions on how to edit one’s sandbox, for example, but they may not be able to pull in a self-contained sandbox for users to play in, or offer a radio-button quiz)
  • Module has not been extensively tested with setups that include translation; it's possible this will need fine-tuning by someone fluent in Lua or the details of the translate extension
  • Format somewhat cramped when viewing it on mobile


The Wiki Education Foundation has developed a training "dashboard" system for delivering educational content to users. With the help of Sage Ross, the Support and Safety team has been able to design a prototype of our training modules that would make use of this more-mature tool to deliver their content. This is still a work-in-progress, but is live on the Wikimedia Foundation-owned Programs & Events Dashboard on WMFlabs.

Pros and cons of using a WikiEdu-style dashboard


  • Extremely user-friendly design and interface
  • Can integrate "live" quizzes and knowledge checks
  • Allows users to "join" a module, track their progress, and (if needed) have their completion of module work recorded for verification by their community, etc
  • Can draw content (including translations) and organization of modules from on-wiki pages (meaning they can be edited by anyone with on-wiki access, and users who prefer to view content only on-wiki can access it there)



  • Runs on an off-wiki (though WMF-owned) site
  • Complex creation of a module on the Dashboard means it must be set up (and updated, when needed) by an experienced Wikimedian who can work with .json files as well as nested page/template calls
  • Currently, quiz/knowledge testing structures cannot be pulled from onwiki; changing this would require significant time investment from the WikiEdu staff who are assisting us This work is actually nearly done, thanks to Sage!

Using a navbox to move among module pages

This is a simple setup that breaks module content into lessons of whatever desired size. Users of the module are not directed through them in order, but are given a navbox on each page from which they can choose among lessons.

Pros and cons of using a navbox setup


  • Runs natively on-wiki, including translations
  • Extremely simple to set up (create content pages as normal, fill out a navbox template, place template onto each page)
  • Easily understandable and usable by anyone with a small amount of on-wiki experience
  • Users can decide how to move among the lessons


  • Navboxes do not work on mobile
  • Does not lead users through lessons in order, which may be confusing
  • No progress tracking

Using a "tabs" bar at the top of the page

This is a format many Wikimedians are already familiar with; it presents a persistent tab bar at the top of each module page. Though users are not directed through the tabs in a specific order, they are visually organized (and further organizable) in an order that will be easy for users to follow.

Pros and cons of using a tab bar


  • Works on mobile
  • Format is familiar to most Wikimedians; how to use navigation tabs is intuitive to most computer users
  • Setup of tab bar is reasonably simple for experienced Wiki editors
  • Top-of-page placement makes user navigation easy
  • Runs natively on-wiki, including translations


  • Format somewhat cramped when viewing on mobile; may require side scrolling
  • Does not lead users through lessons in order, which may be confusing
  • Because modules have a large number of sub-lessons, tab bar somewhat difficult to format in a way that's not highly compressed and/or that consumes too much space on the page
  • Setup requires someone who is reasonably comfortable with templates and divs
  • No progress tracking

Using a single-page view

A single-page view is the simplest implementation of module content; as the name implies, it presents the entirety of the module's content on one page.

Pros and cons of using a single-page view


  • Makes it easy for users to print modules, or download them to another reading format like Pocket or Instapaper
  • Setup effort is negligible for anyone capable of basic wikimarkup
  • No complex navigation for users to negotiate; page's scroll bar gives them an approximation of progress
  • Generally should work on mobile, other than potentially some templates (which could be optimized to work on mobile if needed)
  • Runs natively on-wiki, including translations


  • Slower page loads for anyone on limited bandwidth
  • Single, large chunk may make content less easily approachable
  • No explicit progress tracking
  • Lacks the interactive quality of a module that presents lessons individually

Major design concerns

Below are some potential design and formatting issues we are already thinking about and would like to hear your opinions about; however, this is not an exhaustive list, so please feel free to raise relevant issues we haven’t thought of!


  1. これらモジュールを特定のウィキメディアのプロジェクト(つまりで 表示を義務化 するべきでしょうか?
    • そう考えるのはなぜですか?
  2. Do you believe these modules should, but not must be hosted on a Wikimedia project?
    • If so, under what circumstances would you accept the modules being hosted off-wiki? For instance, if using an off-wiki venue allowed us to make the modules more interactive, or use multimedia, or allow users to track their progress, would those be valid reasons to opt for off-wiki?
    • Would you make a distinction between a “completely off-wiki” venue such as an independent site, and a “semi-off-wiki” site like Tool Labs or that, while not a Wikimedia Project, is under the Wikimedia umbrella? Would one of these types of “off-wiki” be more acceptable than another?
  3. If we were to host these modules off-wiki, what factors would you want us to make sure we could address in terms of user rights and security? For instance, data retention by the hosting site, copyright concerns of the hosting site…


Not every user of our modules will be typical in every way, and many may need to access or view the modules in ways that accommodate their needs. What types of accessibility concerns must the modules take into account? Pick as many of the following as you wish, or add your own:

  • Screen readers: modules must work with screen reading software
  • General visual impairment: modules must be usable at high zoom, must use accessible color schema.
  • Mobile users: modules must be both readable and usable by people viewing them on mobile
  • Low bandwidth: modules must not be designed in such a manner that users on slow or metered internet connections cannot or will not want to use them


  1. Should modules be available in a single-page format?
    • As the default?
    • As an option the user can select?
  2. If you think the modules should be available in a multi-page format, what is the best limit to draw for the size/complexity of an individual page? For instance, X seconds of load time on an average connection, X minutes of reading time, one whole lesson...
  3. How structured should the modules be? Should the user be stepped through content and lessons in a specific order, or should they simply be provided with all the information the module contains and allowed to decide how to work through it?
  4. What form should the primary content of the modules be presented via? For instance, video, long-form prose, short-form prose...

Potential delivery mechanisms

There exist a handful of pre-existing extensions, modules, and tools that could potentially be used to deliver our training modules. Here are a few we know of; please let us know if you think any of these are appropriate, or if you are aware of any similar platforms we aren't.

  • Module:Training Pages- an extension and set of templates that allow structured navigation through and presentation of training content
    • Pros: Operates on-wiki, already written, makes module content easily consumable by users
    • Cons: May need more development to work flawlessly with translation, is quite complex to set up
  • WikiEdu Training Dashboard(running either on the WikiEdu site or, potentially, on a Training Module-specific place on Tool Labs)
    • Pros: Has a number of features that could be useful in our modules (interactive quizzes, progress tracking, well-controlled bandwidth usage)
    • Cons: Operates off-wiki, coded using specialized Javascript markdown (.yaml) that would need to be learned by module designers, currently does not support translation of module content via a mechanism other than “create a whole separate module for each language”


For each of the following types of content, we'd like to hear opinions on whether the modules must have them, should have them, should not have them, or must not have them. If you feel any use of a given feature may be optional but must not be mandatory for completion of the module, please tell us that too.

  1. 動画:
    • Content (for instance, the main body of a module would be a “lesson” video)
    • Demonstrations (for instance, role-playing event organizers handling a Friendly Spaces violation)
    • Background information (for instance, someone speaking on video about how harassment has affected them)
  2. 音声:
    • Content (for instance, the main body of a module would be “lesson” audio)
    • Demonstrations (for instance, role-playing event organizers handling a Friendly Spaces violation)
    • Background information (for instance, someone speaking on video about how harassment has affected them)
  3. 利用者の活動:
    • 単独の活動(例えば自分の利用者空間で実施するお題を出す)
    • Group user activities (for instance, asking users who are taking the module to participate in a talk page discussion or practice scenario with other users currently taking the module)
  4. クイズ類
    • Non-interactive quizzes (for instance, a module might present a list of questions and ask a user to create a page in their sandbox for their answers)
    • Interactive user quizzes (for instance, a module might have a javascript-based quiz embedded in it, where users answer questions and then submit the quiz)
    • Non-graded quizzes or passing-optional quizzes (a user's score on a quiz does not affect their ability to move on in the module)
    • 初級中級上級あるいは正解・不正解式のクイズ(一定の得点なり正解率を出さないとモジュールの次の段階へ進めない)
  5. 笑い(例えば主題をテーマにした面白いGIF画像や漫画)
  6. 現実世界のサンプル(例えば匿名化してある過去の嫌がらせ事案の報告書)


  1. 利用者がモジュールを完了した時点で、もし該当するなら以下のどれかを実施しますか?
    • バーンスターをもらえる
    • 「完了証明書」をダウンロードできる
    • 利用者に「おめでとう」メッセージが届く
    • WMF に対して、モジュールを体験した利用者として感想を送るようにお勧めする
      • 公開(モジュールのトークページ)
      • 非公開(Eメール)
  2. コミュニティや主催者にとってこれらのモジュールが有益な場合、皆さんのコミュニティから WMF に要請して、以下の要件の調整もしくは承認の検討をしてほしいでしょうか?
    • 皆さんのコミュニティが求める要件として、特定の利用者権限を預かる人には学習モジュールを体験するか完了することを義務化する
    • 皆さんのコミュニティが求める要件として、イベント主催者には学習モジュールを体験するか完了することを義務化する
    • 皆さんのコミュニティによる協議の過程で、そのうちの誰かに学習モジュールを体験もしくは完了してもらうかどうか話し合ってもらう
    • イベントモジュールが扱うイベント全てもしくは一部で公開のプレゼンを実施(学習イベントの参加者むけIRLでコミュニティ参加者を支える)
    • 皆さんのコミュニティで関心が高い話題のために新しい学習モジュールを作成するには


  1. See the following, which set the structure for the prototype module: