Growth/Structured mentor list/hu

Ez az oldal a csapat munkáját írja le a "Strukturált mentorlista" projektben. Ez az oldal tartalmazza a főbb eszközöket, terveket, nyitott kérdéseket és döntéseket. Az előrehaladásról szóló legtöbb apró frissítés az általános Növekedési csapat frissítések oldalára kerül, néhány nagyobb vagy részletes frissítés pedig ide.



Jelenlegi állapot

 * 2021-11-22: megkezdődik a projekt megtervezése
 * 2022-01-15: megkezdődik a tervezés
 * 2022-08-04: a strukturált mentorlista elérhető az összes béta wikiben és a test.wikipedia.org oldalon (Phabricator feladat)
 * Következő: A strukturált mentorlista telepítése a növekedés kísérleti wikikre (Phabricator feladat)

Összefoglaló
A strukturált mentorlista egy új mód a mentorok feliratkozására. A wikitext-alapú lista (példa) helyett a mentorok a mentorok irányítópultjába épített űrlapokon keresztül jelentkezhetnek be a mentorálásra, és módosíthatják az adataikat, például az üzenetüket vagy a hozzájuk rendelendő kezdők számát.



Miért csináljuk ezt?
Jelenleg a közösségeknek wikitext-alapú mentorlistát kell fenntartaniuk (példa az angol Wikipédián, docs), amely egy közönséges wiki-oldal, előre meghatározott struktúra nélkül. Ennek a megközelítésnek számos hátránya van:


 * Korlátozott bővíthetőség: A mentor felhasználónevét és üzenetét pipával elválasztjuk egymástól (a  karakter). Ez nem jelent problémát, ha az üzenet az egyetlen attribútum, amit a mentorok beállíthatnak, de nem lenne praktikus ugyanazt a listát használni a mentorral kapcsolatos további információk tárolására (például témák, amelyek iránt a mentor érdeklődik vagy az időbeli elérhetősége).
 * Hibaérzékeny: 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.

Mentors' signup and customization
Non-mentors who want to sign up as mentors can use the Mentor dashboard to sign up. To ensure only trusted users can enroll as a mentor, two new mentorship-related options are available within Community configuration (see image on the right). Using those options, community will be able to define minimum requirements for mentors: a minimum number days of presence and a minimum number of edits. Mentor dashboard will ensure that only mentors who meet the minimum criteria are allowed to sign up.

Mentors who want to edit their introduction message, change how many mentees they are assigned, or take another action related to mentorship, will be able to do so via the Mentor dashboard as well. Minden mentor csak a saját adatait tudja módosítani (például Jane mentor csak a saját üzenetét tudja módosítani; John üzenetét nem tudja módosítani).



Közösségi ellenőrzés a mentorok felett
Annak érdekében, hogy a közösség ellenőrizni tudja, hogy ki a mentor, az adminisztrátorok használhatják a  funkciót. Ez a speciális oldal megmutatja a mentorok listáját, és lehetővé teszi az adminok számára, hogy eltávolítsák bármelyiküket. If the "Remove" button is clicked, they're removed from the mentor list, and all their mentees are assigned to a different mentor. A nem adminok is meglátogathatják a  oldalt, de nem látják az "Eltávolítás" gombot.

A mentorok, a bejelentkező szerkesztők vagy az adminisztrátorok által végrehajtott összes módosítás megjelenik az MediaWiki:GrowthMentors.json oldal előzményeiben.

Abban az esetben, ha közvetlen hozzáférésre van szükség a mentorlistához, az adminisztrátorok és a felület adminisztrátorai képesek közvetlenül szerkeszteni az alapul szolgáló JSON oldalt.