Growth/Structured mentor list/cs

Tato stránka popisuje práci týmu na projektu „Strukturovaný seznam mentorů“. Tato stránka obsahuje nejdůležitější informace, otevřené otázky a rozhodnutí. Více novinek týkající se práce týmu Growth najdete na obecné stránce s aktualizacemi. Závažné a větší aktuality budou pak vloženy i sem.

Současný stav

 * 2021-11-22: zahájeno plánování projektu
 * 2022-01-15: vývoj zahájen
 * 2022-08-04: strukturovaný seznam mentorů je k dispozici na všech beta wiki a na test.wikipedia.org (úkol v Phabricatoru)
 * Další: Nasadit strukturovaný seznam mentorů na pilotní wiki (úkol v Phabricatoru)

Shrnutí
The Structured mentor list is a new way for mentors to sign up. Instead of signing up via a wikitext-based list (example), mentors will use forms incorporated into the Mentor dashboard to enroll into mentorship and to change their information, such as their message or number of newcomers they want to be assigned to.

Proč to děláme?
Currently, communities have to maintain a wikitext-based mentor list (example at English Wikipedia, docs), which is a regular wikipage, with no predetermined structure. This approach has a several of disadvantages:


 * Omezená rozšiřitelnost: Uživatelské jméno mentora a jeho uvítací zpráva jsou oddělená svislítkem (znak ). To není problém v okamžiku, kdy mentoři mohou nastavit jen svou zprávu. Toto řešení ale není praktické, pokud bychom chtěli mentorům umožnit nastavit nějaké další atributy týkající se mentorství (např. témata, která je zajímají nebo jejich časová dostupnost).
 * Snadno vzniknou chyby: Když členové komunity mění seznam mentorů, je velmi jednoduché udělat chybu a jako mentora omylem zapsat nesprávného uživatele. Toto se stává, protože seznam mentorů není jednoduché strojově zpracovat (viz následující bod).
 * Obtížné na strojové zpracování: 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.
 * Obtížné na přípravu: 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.

Strukturovaný seznam mentorů všechny tyto problémy řeší. Protože data jsou uložena v jmenném prostoru MediaWiki ve formátu JSON (viz sekce #Jak to funguje?), seznam mentorů může být snadno rozšířen o další atributy nebo zpracován strojem. Protože mentoři mění informace uvedené v seznamu mentorů s využitím formulářů připravených Growth týmem (namísto ručních editací), je obtížné seznam mentorů rozbít nesprávně uloženou editací.

Jak projekt ovlivní komunity?
Nasazení Strukturovaného seznamu mentorů změní většinu postupů souvisejících s mentorstvím. 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.

Konfigurace


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. Each mentor will be only able to change their own details (for instance, mentor Jane is only able to change her own message; she will be unable to change John 's message).

Community control of Mentors
To ensure the community has control over who is a mentor, administrators will be able to use. This special page shows a list of mentors, and allows admins to remove any of them. If the "Remove" button is clicked, they're removed from the mentor list, and all their mentors are assigned to a different mentor. Non-admins can visit  as well, but they do not see the "Remove" button.

All changes made by mentors, enrolling users, or administrators will show in the MediaWiki:GrowthMentors.json page history.

In case direct access to the mentor list is needed, administrators and interface administrators are able to edit the underlying JSON page directly.