Configuration communautaire
|
Configuration communautaire
 Généraliser le concept de Configuration communautaire pour qu'il soit utilisable par tout développeur MediaWiki.
|
Résumé
L'équipe Croissance a développé la Configuration communautaire pour aider les communautés à personnaliser et à dimensionner les fonctionnalités de Croissance. Avec le succès de cette fonctionnalite (Ue nous considérons comme la première itération de la Configuration communautaire actuelle), il est devenu évident que les autres équipes de la WMF, les développeurs externes et les autres utilisateurs de MediaWiki pourraient bénéficier de cet outil, et donc l'équipe Croissance explore la possibilité de déplacer cette fonctionnalité de l'extension GrowthExperiments vers une extension séparée CommunityConfiguration.
Ce projet comprendra une consultation de la communauté, une discussion avec les partenaires techniques, des améliorations d'architecture dimensionnable, et un travail d'ingénierie pour transporter la fonctionnalité de Configuration communautaire à partir de l'extension GrowthExperiments vers une extension séparée. A court terme ce projet prendra en charge les projets de l'équipe des Outils d'édition et de modération (Edit check et Automoderator), et à long terme, ce travail permettra de faire évoluer la manière dont les équipes des produits et technologies de la WMF développent et déploient les fonctionnalités.
La priorité accordée aux travaux sur la configuration communautaire reconnaît que chaque communauté a des besoins uniques et que les membres de la communauté investis devraient être habilités à configurer les caractéristiques pour répondre à ces besoins. Cette approche supprime la barrière pour les modérateurs non techniques de personnaliser les paramètres de projet pour leurs communautés et favorise un processus de développement de produits plus inclusif et collaboratif, permettant ainsi à la WMF de mieux servir le mouvement Wikimedia.
Etat actuel
- - Le travail a commencé sur la Configuration communautaire de Croissance
- - La Configuration communautaire de Croissance est disponible sur tous les wikis de Croissance
- - Session de hackathon : Configuration communautaire – permettre aux communautés de prendre le contrôle à l'aide de la configuration JSON (diapositives de session hackathon, Google Slides)
- - Présenter les plans initiaux au Wikimania (Moderator support slides)
- - Technical RFC announced on wikitech-l
- - La Configuration communautaire 2.0 est renommée en Community Configuration, pour simplifier. La Configuration de la communauté Croissance est considérée séparément comme un pré-projet.
- - The Community Configuration extension was released to all Beta Wikipedias and Test Wikipedia.
- - The Community Configuration extension was released to Growth Pilot wikis (Spanish and Arabic Wikipedia).
En cours: Release to all Wikipedias (T360571)- Suivant: more configurations are made available.
Hypothèse
Si les éditeurs avec des droits étendus peuvent configurer de manière transparente et facile des fonctionnalités importantes sur le wiki pour tous les utilisateurs, les communautés auront le contrôle de la façon dont les fonctionnalités opèrent sur leurs wikis, et les équipes de la WMF pourront envoyer de nouvelles fonctionnalités rapidement.
L'équipe Croissance est guidée par le Plan annuel de la Fondation Wikimedia et les Objectifs et résultats clé du département Produit et technologie. Cette hypothèse et le projet associé sont l'un des projets multiples de l'équipe WMF sous le Résultat clé des WikiExperiences 1.2, qui s'intéresse à l'accroissement de l'expérience utilisateur pour les éditeurs qui possèdent des droits étendus.
L'équipe Croissance et cinq autres équipes de la Fondation Wikimediase se concentrent sur les projets relatifs à cela pour le résultat-clé des WikiExperiences 1.2.
Cas d'utilisation
Il existe de nombreux cas d'utilisation qui soulignent la nécessité d'une façon standard de configurer les fonctionnalités de la communauté. La configuration communautaire sera plus extensible et évolutive, et utilisable en dehors de l'extension GrowthExperiments, ce qui la positionnera comme un atout précieux pour les autres équipes de la WMF et leurs caractéristiques respectives. La Configuration communautaire a été identifiée comme un besoin par plusieurs équipes de la WMF et leurs priorités du plan annuel associé :
- Equipe d'édition : vérification des modifications
- Cas potentiel d'utilisation : les Communautés configureront lorsqu'un contrôle d'édition de référence sera déclenché ainsi que le message résultant et les sorties.
- Equipe de l'outil Moderator : Automoderator
- Cas potentiel d'utilisation : les Communautés configureront Automoderator pour qu'il ne prenne les actions que sur certains groupes d'utilisateurs.
- Equipe Confiance et sécurité du produit : Système de rapport des incidents
- Cas potentiel d'utilisation : les communautés vont configurer les voies des différents types de rapports d'incidents, ainsi que les règles concernant qui peut utiliser le système et dans quelle situation.
- Equipe des sondages : extension CampaignEvents
- Cas potentiel d'utilisation : les communautés voudrons configurer les espaces de noms autorisés pour les pages d'événement et qui sera éligible pour les droits d'organisateur pour déclarer l'enregistrement des événements.
- Equipe de l'application pour mobile : outils anti-vandalisme pour l'application Android.
- Cas potentiel d'utilisation : les communautés peuvent créer des modèles d'avertissement à afficher sur les applications officielles pour mobile de la WMF et les applications tierces de patrouillage.
- Equipe Web : accessibilité de la lecture
- Potential use case: Communities may need to configure default font sizes, as certain language scripts need to be larger to be readable and meet accessibility needs.
Beaucoup d'autres cas d'utilisation ont été discutés par les membres de la communauté et ils sont listés dans l'épic associée : T323811.
Buts
Ce que nous voulons
- Créer un outil facilement compréhensible par tout contributeur expérimenté.
- Donner aux communautés la possibilité de personnaliser les fonctionnalités du wiki pour mieux répondre aux besoins locaux de leur wiki.
- Créer un outil qui aide à accroître la vitesse avec laquelle les équipes de produits et de technologie de la WMF peuvent étendre les fonctionnalités à tous les wikis.
- Créer un outil qui aide les développeurs bénévoles, les créateurs de gadgets et tout développeur de logiciel intéressé par créer des outils communautaires configurables pour MediaWiki.
Ce que nous ne voulons pas
- Créer un outil qui crée des préjugés ou qui ne profite qu'à un groupe d'utilisateurs.
- Créer un outil qui fonctionne uniquement avec certaines fonctionnalités.
- Créer un outil difficile à trouver ou à comprendre.
Résultats clé
Les objectifs et les résultats clé de ce projet seront établis en collaboration avec des rédacteurs ayant des droits étendus. Quelques résultats clés potentiels pourraient être :
- D'ici fin mars 2024, les fonctionnalités de croissance configurables utiliseront la configuration communautaire.
- D'ici fin juin 2024, au moins une autre équipe du WMF en matière de produits et de technologie aura lancé ou est en phase de développement active d'un projet utilisant la configuration communautaire.
- By the end of the fiscal year, Community Configuration has been used to customize at least 20 wikis. In other words, editors with extended rights are aware and utilize Community Configuration.
- By the end of the fiscal year, initial guidelines for the types of functionality that should and should not be in Community Configuration, and types of user rights, will be agreed in consultation and collaboration with volunteers and interested product teams.
Considérations techniques
Leçons techniques de la Configuration communautaire 1.0
La configuration communautaire 1.0 fut un défi pour les éléments suivants :
- Changes: Once a configuration value has been first configured on-wiki, it is challenging to change its format (one has to edit the configuration files and update their format). CC 1.0 is problematic at backwards and forwards compatibility.
- External access: Configuration values cannot be easily accessed from external clients (such as the Android app), ie. without loading the underlying JSON page, the structure of which can be changed without notice by the Growth team.
- Extensibility: Adding new fields to the configuration form is not terribly difficult, but it is often forgotten about. The backing JSON files give admins access to more than what Special:EditGrowthConfig offers. Unfortunately, most “hidden capabilities” are only known by Growth engineers.
- Deletability: Configuration stored as on-wiki JSON files has its disadvantages. The biggest disadvantage Growth team ran into is that they can be deleted (example: T344013). Once that happens, the Growth features revert to extension.json-provided defaults, which disrupts the experience to newcomers (although nothing broke from a technical perspective, the user experience is nearly-unusable).
- Suddenness: It is worth knowing about certain configuration changes when they happen, so they can be properly reacted to. For example, if a wiki decides to turn off Add link, the Growth team would want to learn why and if possible, resolve issue(s) identified by the community. This is not (easily) possible with CC1.0.
Contraintes techniques de haut niveau
La configuration communautaire devrait être :
- Auditable: Any change made to the configuration should be auditable, including the reasons for “who made the change”, “why the change was made” and “what the change consisted of”. The experience should be comparable to the history of MediaWiki pages, as that is what the users are used to.
- Extensible: Even though we made scoping decisions (eg. to not include gadgets in the MVP), those decisions should not affect ability to extend Community Configuration in the future without significant efforts.
- Externally available: Users external to MediaWiki should be able to access the current setting values configured via Community Configuration. This is needed to ensure Community Configuration values can be used from places outside of MediaWiki (such as the Wikipedia Apps for mobile devices, Toolforge tools and similar).
Discussion de la communauté
Dans le cadre de ce projet, nous consulterons trois groupes principaux d'intervenants :
- Wiki communities: Including Wikipedia admins and users with extended rights that have used Growth's Community Configuration previously or might utilize Community Configuration in the future. We will also consult with developers of user scripts and gadgets.
- Technical community: A wider discussion with the technical community as a whole (wikitech-l, MediaWiki core developers.
- WMF teams: Wikimedia Foundation Product and Technology teams interested in utilizing Community Configuration in upcoming projects.
Questions ouvertes
- Que pensez-vous de la perspective que davantage d'équipes WMF développent des fonctionnalités qui peuvent être activées, désactivées et configurées par vos administrateurs locaux de wiki ? Avez-vous des réserves ou des préoccupations à propos de ce projet ?
- Que pouvons-nous faire pour nous assurer que tous les administrateurs sont bien informés de ces outils ?
- Les administrateurs ont-ils confiance dans la possibilité d'apporter des modifications à la Configuration communautaire ? Quelles parties de la procédure ne sont pas claires ou sont ambigües ?
- Alors que la Configuration communautaire devrait être visible pour tous, elle ne devrait être modifiable que par un groupe sélectionné de Wikimédiens expérimentés ? Toutes les options de configuration doivent-elles être éditables exclusivement par les administrateurs et les administrateurs d'interface ? Devrions-nous envisager différents niveaux d'accès des utilisateurs pour certaines options de configuration communautaire ?
- Avez-vous des idées ou des suggestions sur la meilleure façon de définir et de mesurer le succès de ce projet ?
- Portée de la configuration communautaire : elle prend en charge les scripts utilisateur, les gadgets, les applications externes (comme l'application Wikipedia Android / iOS).
- Comment gérer les modifications de configuration qui doivent s'appliquer à (presque) tous les projets Wikimedia ?
Communautés des wikis
Le spécialiste des relations communautaires de l'équipe Croissance a contacté les administrateurs qui ont récemment modifié la Configuration communautaire de l'équipe Croissance (T336608). Les principales idées que les administrateurs ont communiquées sont :
- Les rôles et processus habituels pour suivre et modifier la configuration sont par préférence :
- Toutes les pages de configuration doivent être lisibles par tous.
- Les administrateurs (ou les administrateurs d'interface) devraient être en mesure de modifier parce qu'ils ont suffisamment de connaissances.
- Les administrateurs peuvent appliquer les demandes faites après une discussion communautaire.
- Il est nécessaire d'avoir un historique des demandes et de suivre les modifications.
- Cette page de configuration peut avoir un impact sur de nombreux utilisateurs et doit être traitée avec soin. Plusieurs moyens de prévenir les problèmes ont été suggérés :
- La création d'un nouveau rôle pour les administrateurs de confiance qui comprennent la Configuration communautaire.
- Création d'un processus de révision pour valider unemodification faite par un administrateur.
- Une page d'historique claire et centralisée est nécessaire pour repérer les changements apportés aux différentes configurations.
Présentation Wikimania
Le responsable des produits de l'équipe Croissance s'est présenté au Wikimania Singapour pour partager les détails initiaux sur le projet de configuration communautaire ainsi que sur d'autres projets que les équipes de la WMF sont en train de mener à bien pour soutenir les modérateurs. Nous avons répondu aux questions suivantes des participants :
- La page Special: est-elle disponible pour les non administrateurs en mode lecture seule ?
- Oui, la page spéciale est actuellement disponible et affichable par tous. Seuls les administrateurs peuvent actuellement modifier la configuration. Exemple : Special:EditGrowthConfig.
- La Configuration communautaire sera-t-elle disponible sur les autres wikis en dehors de Wikipedia ?
- Currently the 1.0 version of Community Configuration is part of the GrowthExperiments extension and therefore only available on wikis that have that extension enabled. We hope to build the version in a way that is more extensible and flexible so that it can be used on any wiki that installs the Community Configuration extension.
- Our goal is to scale the extension up to all Wikimedia projects. Having Community Configuration enabled across all Wikimedia projects would make it easy to integrate with, as you could rely on the extension always being available in a Wikimedia context.
- Si nous connaissons des cas d'utilisation spécifiques pour la Configuration communautaire, où pouvons-nous partager cette information afin que l'équipe Croissance les prennent en considération ?
- Although we can't make promises that we can support everything in the initial release, we are compiling a list of use cases in the Community Configuration Epic. Any community member with ideas is welcome to add comments to that task with the use case (of course we welcome feedback and comments on the talk page here too).
- Y aura-t-il des cas avec des restrictions supplémentaires ou des avertissements sur ce qu'un administrateur peut modifier ?
- Ce projet comprendra la création de lignes directrices sur l'utilisation de cette fonctionnalité. Nous allons créer une meilleure intégration pour les administrateurs, ainsi que des lignes directrices pour les développeurs pour les ingénieurs qui soutiennent la configuration communautaire de fonctionnalités non liées à la croissance.
- Il y aura également des contrôles d'erreur et des avertissements afin de garantir la plus grande stabilité possible de la configuration communautaire. Par exemple : si le formulaire s'attend à un entier positif dans un certain champ, le formulaire présentera une erreur si un entier négatif ou une chaîne non entière est ajoutée.
- Nous avons envisagé la configuration communautaire qui pourrait éventuellement appuyer un processus dans lequel plus d'un administrateur doit approuver un changement si le changement peut être controversé ou avoir un impact important. Ce ne sera pas une partie du MVP, mais nous pourrions l'envisager dans le futur.
- La Configuration communautaire fonctionnera-t-elle pour les applications externes comme les applications Android et iOS de Wikipedia ?
- La configuration communautaire sera lisible par des applications externes, mais la forme actuelle de la configuration communautaire ne sera pas ajustable par les administrateurs à l'intérieur des applications.
- Will interface admins still be able to make changes to JSON configuration files if they are also Community Configurable, or will these changes now be restricted to updates via Community Configuration?
- La configuration communautaire ne restreindra pas les administrateurs d'interface à apporter des modifications aux fichiers de configuration JSON. Cependant, il se peut qu'à l'avenir, il y ait des configurations que les administrateurs ne devraient pas être en mesure de modifier. Si cela se produit, nous devrons restreindre l'édition manuelle de tout fichier JSON brut associé à cette configuration.
Equipes de la WMF
Nous avons terminé une première tournée d'écoute avec neuf équipes de produits WMF. Voici quelques conseils :
- All teams have either a short-term or long-term need for Community Configuration, the short term needs have been documented as Community Configuration use cases.
- Plusieurs équipes ont noté l'importance de la transparence des données pour les décisions de configuration.
- Plusieurs équipes ont mentionné le besoin de métriques ainsi que la possibilité pour la communauté d'évaluer les décisions de la Configuration communautaire.
- Teams mentioned several social concerns, including: accountability and transparency, balancing legal requirements with community autonomy, discoverability, permissions and user roles, and the need to avoiding increasing patroller burden.
- Teams mentioned a few technical concerns, especially the need for Community Configuration to be nuanced and flexible.
Sondage technique
We conducted a wider discussion with technical stakeholders via starting a wikitech-l thread explaining the project and asking for feedback in the related Phab task (T349757) and the Community Configuration Product Requirements Document. After discussing feedback and responding to concerns by creating follow up tasks (like T351227), we wrapped up the technical RFC.
Recherche
Relecture comparée
The Growth team's designer completed a short comparative review of Admin tools in use on other platforms (T338386). Le rapport complet est disponible ici : Analyse comparative : Configuration / Outils d'administration. Le résumé des informations pertinentes relatives au projet de configuration communautaire de l'équipe Croissance est le suivant :
- La plupart des outils utilisent un tableau des tâches comme première chose que vous voyez lorsque vous entrez dans le panneau – vous pouvez accéder à des éléments comme l'activité récente, les liens rapides, les informations pratiques.
- En termes d'organisation ou de placement, la plupart des outils utilisent des modules tout en ayant une barre latérale à gauche, avec des éléments de menu qui peuvent être étendus dans certains outils.
- Certaines plateformes permettent aux utilisateurs ou aux communautés de personnaliser les modules et leur présentation - par exemple, les modules pouvant glisser vers différentes parties de l'écran, ou pouvant cacher des modules que vous ou votre communauté n'utilisez pas.
- Paramètres de l'interface utilisateur : pour la plupart d'entre eux, les outils utilisent des composants tels que des commutateurs d'option (activé / désactivé), des entrées de texte et des menus déroulants.
- Typologie des paramètres :
- Display settings: being able to change the color/layout/etc. of a feature
- Feature access: being able to activate/deactivate (turn on/off) certain features
- Seuils / Limites : comme une certaine activité ne pouvant pas être faite plus de X fois par jour.
- User access/permissions: only certain user groups having access to a feature
- Audience-specific or other conditional customisation: e.g. links to resources being different from community to community.
Interview des éditeurs
The Growth team partnered with WMF Design Research to complete semi-structured interviews with admins and experienced Wikimedians from English Wikipedia, Spanish Wikipedia, and Swahili Wikipedia. The following are a few key take-aways:
- Participants from smaller wikis are enthusiastic about how “democratizing” Community Configuration is.
- Les participants des wikis plus larges pensent que les restrictions et les permissions qui gouvernent actuellement la configuration continueront de le faire avec la Configuration communautaire.
- Les participants ont constaté que les structures de la Configuration communautaire étaient une amélioration par rapport aux processus et aux systèmes de configuration existants auxquels ils étaient habitués.
- Les préoccupations des participants concernant le fait de permettre à trop de personnes de modifier la configuration se sont réduites une fois que les participants ont interagi avec les prototypes de la Configuration communautaire.
- Les messages explicatifs, l'image du logo et le titre de la page utilisés dans le prototype devraient être réexaminés à la lumière du fait que la Configuration communautaire sera utilisée par de nombreux locuteurs non techniques et non natifs de l'anglais.
Architecture
Architectures initiales
Nous utiliserons ce que nous avons appris de la page Special:EditGrowthConfig existante pour rendre la nouvelle page Configuration communautaire plus conviviale, intuitive et évolutive. Nous étudions actuellement deux concepts d'archite ture principaux pour la page de la Configuration communautaire : une mise en page de style accordéon ou un format style tableau de bord. Nous allons recueillir les commentaires de la communauté pour déterminer quelle structure nous poursuivons et comment nous pouvons améliorer davantage la conception et l'expérience utilisateur de la Configuration communautaire.
-
Concept A : style accordéon -
Concept B : style tableau de bord
Architectures de la seconde itération
As we progressed with designs and community discussions, it became clear that there should be a central page to access all Community Configuration options. This central page will act as a Community Configuration dashboard and allow easily access and navigation to each individual Community Configuration form. The individual feature form is where configuration changes will be saved. The form will also allow for easy access to the configuration edit history, help pages, and related metrics.
-
Conception du tableau de bord de la Configuration communautaire -
Conception du formulaire de la Configuration communautaire pour les caractéristiques du mentorat
Measurement and instrumentation
Community Configuration edits are publicly tracked on the associated history page, so instrumentation needs are fairly minimal. However we would like to be able to answer the following questions:
- How often is the Community Configuration dashboard (Special:CommunityConfiguration) visited?
- How often is an individual Community Configuration edit form visited?
- How often is a Community Configuration edit completed?
Measurement and instrumentation details are available via: T366224.