Growth/Structured mentor list/es

Esta página describe el trabajo del equipo en el proyecto "Lista estructurada de mentoría". Esta página contiene los principales activos, diseños, preguntas abiertas y decisiones. La mayoría de las actualizaciones sobre el progreso se publicarán en la página general de Actualizaciones del equipo de crecimiento, con algunas actualizaciones importantes o detalladas publicadas aquí.



Estado actual

 * 2021-11-22: comienzan las tareas de planificación del proyecto
 * 2022-01-15: engineering starts
 * 2022-08-04: La lista estructurada de mentoría está disponible en todas las wikis beta y en test.wikipedia.org (Tarea de Phabricator)
 * Próximo: Implementar la lista estructurada de mentoría en las wikis piloto de Crecimiento (Tarea de Phabricator)

Resumen
La lista estructurada de mentoría es una nueva forma de inscribirse para los mentores y mentoras. En lugar de inscribirse a través de una lista basada en wikitextos (ejemplo), los mentores y mentoras utilizarán formularios incorporados en el Panel de Mentoría para inscribirse así como para cambiar su información, su mensaje o el número de recién llegados a los que quieren ser asignados.



¿Por qué estamos haciendo esto?
Actualmente, las comunidades tienen que mantener una lista de mentores/as basada en wikitexto (ejemplo en la Wikipedia en inglés, docs), que es una wikipágina normal, sin estructura predeterminada. Este enfoque tiene varias desventajas:


 * Extensión limitada: El nombre de usuario de la persona mentora y su mensaje están separados por una pleca (el carácter ). Esto no es un problema cuando el mensaje es el único atributo que los mentores pueden configurar, pero no sería práctico utilizar la misma lista para almacenar información adicional sobre el mentor (como, sus temas de interés o su disponibilidad).
 * Propenso a errores: Cuando los miembros de la comunidad hacen cambios en la lista de mentoría, es muy fácil cometer un error e [1$ inscribir accidentalmente al usuario/a equivocado]. Esto sucede porque la lista de mentoría no es fácil de analizar (ver el siguiente punto).
 * Difícil de analizar: Es complicado que una máquina "entienda" el wikitexto. Esto hace que sea más difícil para las personas voluntarias de la comunidad técnica y de Crecimiento trabajar con la lista de mentores y aprender más sobre cómo funciona la mentoría en las distintas wikis. El cambio a la lista estructurada de mentoría lo hará más fácil.
 * Difícil de habilitar: Cada comunidad que quiere adoptar el módulo de mentoría de Growth, tiene que crear su propia lista de mentores. Aunque existe documentación sobre cómo hacerlo, a menudo se requiere la ayuda del equipo de Crecimiento. Con la lista estructurada, el único paso necesario para habilitar el módulo será contar con un número suficiente de mentores y mentoras a bordo.

La Lista estructurada de mentoría soluciona todas estas cuestiones. Como los datos se almacenan en una página JSON en el espacio de nombres MediaWiki: (ver #¿Cómo funciona?), la lista puede ser fácilmente ampliada o analizada por una máquina. Como las personas mentoras cambian la información en la lista a través de un formulario (en lugar de editar la lista directamente), es más difícil cometer un error que rompa la lista de mentores.



¿Qué impacto tendrá sobre las comunidades?
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. 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 mentees 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.