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 : It is difficult for a machine to "understand" wikitext. This makes it more difficult for both Growth and technical community volunteers to work with the list of mentors and to learn more about how mentorship works at the various wikis. Switching to the structured mentor list will make it easier.
 *  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.

The Structured mentor list resolves all of those issues. 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?
Deploying the Structured mentor list to a wiki will change most mentorship-associated workflows. 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. The Structured mentor list is available at all beta wikis and the test Wikipedia.



Configuration


Conceptually, the Structured mentor list is similar to the Community configuration project, where the Growth team decided to keep certain settings in an on-wiki JSON page. Similar to what Community configuration does, the actual list of mentors is stored in a JSON page in the MediaWiki namespace, called MediaWiki:GrowthMentors.json (see an example at test.wikipedia.org). We created several forms that support all actions that need to be done with a mentor list that should be easy to utilize. In addition to that, the forms do not require that mentors have admin permissions in order to change their information, as the mentor list is in the  namespace.



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

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



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

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

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