Growth/Structured mentor list/ja

このページではチームによる「構造化したメンター名簿」プロジェクトを扱います. このページでは主要なアセット、設計、未決の課題、意思決定について述べます. 進捗状況で増えた更新のほとんどは一般向けのGrowthチームの更新ページに、このページには特定の大規模または詳細な更新をそれぞれ掲載します.



現在の進捗状況

 * 2021-11-22: プロジェクトの計画立案を開始
 * 2022-01-15: 作成の開始
 * 2022-08-04: 構造化した指導者名簿はベータ版採用のウィキ、test.wikipedia.org に展開済みです. （Phabricator のタスク）
 * 次: 構造化した指導役名簿を Growth チームの初期運実装ウィキに展開（Phabricator のタスク）

要約
この構造化した指導役名簿は、指導役を志望する人の新しい登録方法です. 指導役志望者はウィキ文形式の名簿（example）ではなく、指導役ダッシュボードと連携したフォーム形式類を使って指導役の役割に参加、利用者情報のうち定型メッセージ作成や受け付ける人数の変更ができます.



なぜ、わざわざ取り組むのですか？
現状でコミュニティはウィキ文形式の指導者リストを管理しており（英語版ウィキペディアの例、解説文書）通常のウィキページの扱いのため構造をきちんと設計してありません. この方法には次のようにいくつかの利点があります.


 * 拡張に制限: Mentor's username and their message are separated with a pipe (the  character). This is not an issue when message is the only attribute mentors can configure, but it wouldn't be practical to use the same list to store additional information about the mentor (such as, topics the mentor is interested in or their time availability).
 *  Error-prone : When community members make changes to the mentor list, it is very easy to make a mistake and accidentally enroll the wrong user. This happens, because the mentor list is not easy to parse (see the next point).
 *  Hard to parse : 機械にはウィキ文の「判断」ができません. そのため当 Growth チームも技術系コミュニティのボランティアの皆さんも指導者名簿の処理に苦慮しており、指導役の役割がそれぞれのウィキでどのように機能しているか、見通すことができずにいます. 指導役名簿を構造化すると、もっと簡便になります.
 *  Hard to set up : Each community that wants to adopt Growth mentorship has to create its own mentor list. While there is documentation on how to do it, it often requires the help of the Growth team. With the structured mentor list, the only step needed to get Growth mentorship will be to get a sufficient number of mentors on board.

構造化した指導役名簿ならこれらの課題がすべて解決です. Because the data is stored in a JSON page in the MediaWiki: namespace (see #How does it work?), the list can be easily extended or parsed by a machine. Since mentors change information in the list via a form (rather than editing the list directly), it is harder to make a mistake that would break the mentor list.

What impact will it have on communities?
構造化した指導役名簿の展開は、それぞれのウィキで指導役の役割ワークフローを変えることになります. For instance, instead of going to a wikitext-based mentor list to enroll, a soon-to-be mentor will have to go to to enroll, or to change information about themselves. The Growth team will take care about converting the wikitext mentor list to the new structured mentor list, so no information will be lost.

It might be necessary to update the wikitext mentor list to include useful information (such as, where to enroll or what mentorship is). It is also possible to delete it, and rely on the Mentor dashboard to provide all necessary information to the mentors.

In case you want to test the project in advance, you can! Testing instructions can be found at Wikimedia Phabricator. 構造化した指導役名簿はベータ版を採用したウィキすべてと、test Wikipedia（テスト空間）に展開済みです.



設定


理論上、構造化した指導役名簿はコミュニティ設定プロジェクトに似ており、当 Growth チームでは設定項目の一部をオンウィキの JSON ページとして設置しました. コミュニティ設定の挙動に似て、指導者名簿の本体は MediaWiki 名前空間の JSON 形式のページに置き、MediaWiki:GrowthMentors.json と呼びます. （サンプルは テスト空間 test.wikipedia.org をご参照ください. ） 指導役名簿に菅rんするさまざまな措置に対応するため、使いやすいように複数の書式を作成しました. それに加えて、その名簿は の名前空間においてあり、それぞれの書式に記入する指導役が自身の情報を変更するとき管理者権限は不要です.



指導役の登録と関連のカスタム化
これから指導役になりたいという希望者は、指導役ダッシュボードで登録してください. 信頼のおける利用者に限定して指導役を務めてもらうように、コミュニティ設定に指導役関連の新しい選択肢を2件、新設しました（右の画像をご参照）. これら選択肢を有効にするには、コミュニティが指導役に最低要件を設定できます. アカウント登録後の経過日数に加えて 編集回数の下限の値. 指導役ダッシュボードへの登録は、最低条件に適合する指導役のみ認められます.

指導役は指導役ダッシュボード経由で、自己紹介メッセージや引き受ける人数を変更したい、あるいは指導役の役務に関するその他の措置を希望するときに処理ができます. 1人の指導役は自分自身に関する詳細情報（例えば 花子 が変更できるのは本人のメッセージをに限定され 太郎 のメッセージは対象外）.



コミュニティが指導役を管理
コミュニティには誰が指導役になるか自治を確保するため、管理者は を利用します. この特別ページは指導役の一覧を表示し、管理者は除名や除去を行います. 「除去」ボタンを押すと、指導役名簿から名前が消され、それまで担当した相手は全員、ほかの指導役に割り振られます. 管理者以外の利用者は を閲覧できますが「除去」ボタンは不可視化してあります.

指導役、参加する利用者、管理者の行った変更はすべてページ変更履歴 MediaWiki:GrowthMentors.json に表示されます.

指導者名簿に直接、アクセスが必要な場合は、管理者とインタフェース管理者 は対応する JSON ページを編集すると利用できます.