Projet:Scripts et gadgets/Maintenance 2018 des gadgets

Une page de Wikipédia, l'encyclopédie libre.
Projet Fonctions disponibles Notices Discussion projet Signaler un bug Demander une nouvelle fonction
PROJET SCRIPTS ET GADGETS
Centraliser les fonctions JavaScript et CSS pour éviter la dispersion du code.
 

Cette page permet de regrouper une série d'actions à effectuer dans le but d'améliorer la qualité et la maintenabilité des scripts utilisateurs et des gadgets disponibles sur frWiki, notamment en réduisant la dispersion du code.

Pages d'aide[modifier | modifier le code]

0 % accompli (estimation)

Afin d'éviter que ne se reproduisent les problèmes d'avril 2017, conséquence de la dépréciation de fonctions très utilisées, il est pertinent de rédiger une page rappelant de manière simple et accessible les règles et bonnes pratiques en JavaScript.

Bonnes pratiques pour les utilisateurs[modifier | modifier le code]

Les premiers impactés, et donc les premiers à sensibiliser, sont les utilisateurs finaux, utilisateurs n'ayant le plus souvent aucune compétence en Javascript. Il faut donc leur expliquer les bonnes pratiques quant au contenu de leurs pages common.js, vector.js ou monobook.js (spoiler : pas de code isolé, seulement des imports).

Et réécrire Aide:Personnaliser l'interface

Documentation pour les nouveaux développeurs[modifier | modifier le code]

Débuter dans le développement de scripts ou de gadgets dans l'environnement MediaWiki peut s'avérer assez complexe, faute de trouver la documentation adéquate (il y a plein de trucs qui existent, mais souvent difficiles à trouver par soi-même). Ainsi, énormément de scripts font la même chose, en moins bien, que des librairies directement incluses dans le code de base du logiciel de MediaWiki.

De ce fait, un guide complet du parfait débutant en développement de scripts, guidant les novices vers les bonnes ressources, et les aidant à faire leurs premiers pas dans ce monde hostile, permettrait :

  1. d'améliorer le code présent dans son ensemble ;
  2. d’attirer de nouveaux développeurs.

Liste des pages du projet JS à actualiser[modifier | modifier le code]


100 % accompli (estimation)

Directement dans l'editenotice des pages common.js, vector.js ou monobook.js, avertir les utilisateurs des implications que peut avoir leur édition, les responsabiliser quant à leur contenu, et les renvoyer vers les pages rappelant les bonnes pratiques, permettraient de sensibiliser bien plus de personnes, potentiellement tous les contributeurs adeptes de ces scripts.

Retrait de vieux gadgets[modifier | modifier le code]

100 % accompli (estimation)

Un gadget, qu'il soit utilisé ou non, représente une charge en terme de maintenance. Pour faciliter celle-ci, une piste d'action est le retrait de vieux gadgets, ceux créés il y a de nombreuses années, qui n'ont plus de mainteneur actif, et que le contexte actuel rend obsolètes (fonctionnalité(s) directement intégrée(s) au logiciel MediaWiki, changement des pratiques, etc.).

➜ Étape 1 : identification.
Étape 2 : avertissement sur le Bistro.
Étape 3 : retrait des gadgets.
✔️ Fait — 0x010C ~discuter~

Centralisation[modifier | modifier le code]

Enregistré sur Phabricator
Tâche 159334
0 % accompli (estimation)

Centraliser sur meta ou mediawiki les gadgets qui sont utilisés sur plusieurs wikis.

Réécriture du code[modifier | modifier le code]

41,6 % accompli (estimation)

Recoder les vieux gadgets pour qu'ils respectent les bonnes pratiques actuelles, et qu'ils fonctionnent plus efficacement.