wiki

Maintenance du osu! wiki

Voir également : Guide de contribution au osu! wiki

Cet article décrit les aspects techniques ou administratifs du osu! wiki. Il couvre également les procédures de maintenance, qui sont nécessaires pour le maintenir à jour - peut-être pourriez-vous aider avec l'une d'entre elles. Pour toutes les discussions relatives au wiki, utilisez le salon de discussion #osu-wiki du serveur Discord osu!dev.

Administrateurs

Page principale : Liste des maintainers du osu! wiki

Les administrateurs sont des personnes ayant un accès collaborateur au dépôt ppy/osu-wiki, où tous les articles et les news sont stockés. Ils peuvent trier et étiqueter les problèmes, gérer les pull requests et prendre des décisions concernant le présent et l'avenir du wiki.

Les maintainers effectuent la review finale des pull requests et les fusionnent. Si vous avez une contribution qui nécessite de l'attention, demandez à l'un d'entre eux dans le salon de discussion #osu-wiki.

Détails techniques

Suivi des problèmes

Le suivi des issues du osu! wiki contient des idées et des demandes d'améliorations possibles, tant pour les articles eux-mêmes que pour les parties du site liées au wiki. Ouvrez un problème si vous avez une demande de fonctionnalité, ou si vous avez trouvé une erreur sur l'une des pages. Veuillez noter que **cette procédure est uniquement limitée au osu! wiki - si vous avez besoin d'aide pour d'autres projets officiels liés à osu!, utilisez leur propre suivi des issues :

Labels des issues

Sur GitHub, les pull requests et les issues peuvent être tagués et classés à l'aide de labels, qui montrent différents aspects d'un pull request ou d'un issue. Les labels sont informatifs, définis par les maintainers du wiki, et sont généralement auto-explicatifs. Bien qu'ils ne nécessitent aucune action de la part de l'utilisateur, les labels rouges servent de rappel ou d'appel à l'action pour les autres maintainers :

  • rule change : le changement affecte un ensemble de règles existant, comme les critères de classement, et doit être examiné par le propriétaire de la zone.
  • blocked : le changement présente des problèmes qui doivent être résolus avant de poursuivre, ou dépend d'un autre problème qui doit être résolu en premier lieu.
  • needs native review : la traduction doit être vérifiée par une personne maîtrisant la langue concernée ; sinon, pendant le processus de fusion, cela signifie qu'une telle review n'a pas eu lieu
  • needs rebase : la pull request comporte trop de petits commits non structurés, qui doivent subir un rebase et être mieux formulées ; cette opération est généralement effectuée par les maintainers juste avant la fusion.

Liens et redirections

La plupart des articles du osu! wiki ont des liens alternatifs, qui sont configurés à l'aide du fichier redirect.yaml. Les redirections sont destinées à être utilisées en dehors du osu! wiki, par exemple, sur les forums ou dans le tchat, où elles peuvent être rapidement transformées en référence en ligne :

Selon les [[RC]], ceci est interdit.

Lorsque vous ajoutez des redirections pour un article nouveau ou existant, gardez à l'esprit qu'elles doivent être concises et conçues pour une utilisation réelle.

CI checks

Le dépôt osu! wiki utilise une continuous integration (CI) pour vérifier automatiquement les pull requests entrantes afin de détecter diverses erreurs courantes. La liste des vérifications est configurée dans le fichier continuous-integration.yml.

Le fichier package.json liste tous les plugins utilisés par le CI, dont certains ont été écrits par les maintainers du osu! wiki.

Les vérifications du CI sont exécutées automatiquement sur chaque commit d'un contributeur récurrent. Pour que leurs pull requests soient fusionnées, les contributeurs doivent corriger les erreurs signalées par le CI. Pour voir le statut des vérifications, procédez comme suit :

  1. Faites défiler la page de la pull request, trouvez la ligne d'état osu-wiki continuous integration, et cliquez sur le lien Details.
  2. Sur la nouvelle page, développez l'étape run remark on changed files. Chaque constatation est accompagnée de son emplacement exact dans un fichier et d'une courte description de la raison pour laquelle il s'agit d'une erreur.

Si vous avez besoin d'aide pour décrypter les erreurs de vérification des CI, ou pour résoudre des problèmes, demandez dans le salon de discussion #osu-wiki sur Discord, ou regardez sur ce dépôt.

Développement

Le osu! wiki est intégré au site web d'osu!, ce qui signifie que toutes les demandes de fonctionnalités techniques doivent être faites et suivies dans le dépôt ppy/osu-web. Pour informer les autres contributeurs de votre demande, assurez-vous d'envoyer un lien de l'issue dans le salon Discord #osu-wiki, ou le suivi des issues du osu! wiki.

Outils

Certaines fonctionnalités ne sont pas directement liées au site web d'osu!, mais peuvent être utiles pour contribuer ou faire le ménage. Dans ce cas, elles sont implémentées par des personnes capables de le faire et ne sont pas ajoutées au site web directement :

  • osu-wiki status : liste des articles par langue, et la catégorie de maintenance qu'ils requièrent (traduction, mise à jour). Voir ppy/osu-wiki#2486 pour les demandes de fonctionnalités.
  • osu-wiki-bin : un utilitaire Node.js pour les vérifications et les modifications automatisées (liens cassés, mises à jour des groupes d'utilisateurs, remplacement de textes à l'échelle du wiki, etc.)
  • flag-wiki-osu : ajoute automatiquement les références aux drapeaux mentionnés dans un article. Voir ppy/osu-wiki#328 pour les demandes de fonctionnalités.

Routines

Remarque : le site osu-wiki status présente une liste de tous les articles nécessitant une maintenance, classés par catégorie.

Le wiki repose sur les contributions de la communauté d'osu!. Vous pouvez aider les maintainers et les autres contributeurs en faisant votre part. Pour savoir comment faire, lisez le guide de contribution. Si vous êtes bloqué, demandez de l'aide sur le salon #osu-wiki du serveur Discord osu!dev.

Traductions

Pour une liste des traductions à faire, voir : osu-wiki status

Le osu! wiki est lu par des gens du monde entier. Pour aider votre communauté locale et attirer de nouveaux joueurs, mappeurs, moddeurs et développeurs géniaux dans le jeu, vous pouvez traduire les articles anglais ou mettre à jour les traductions existantes qui ont pris du retard. Consultez la liste des langues prises en charge par le osu! wiki et assurez-vous que votre traduction respecte le principe de parité de contenu. Si vous êtes un utilisateur courant et un rédacteur expérimenté, prenez en charge des sujets clés tels que des articles sur les règles ou les critères de classement. Si vous débutez votre carrière de rédacteur, choisissez un petit article pour recevoir l'aide et les conseils de réviseurs natifs.

Une traduction peut être fusionnée sans native review s'il s'est écoulé plus de deux semaines depuis sa date de création.

Expansion des stubs

Pour l'étendue possible du travail, voir : Liste des stubs existants (anglais)

Certains articles du osu! wiki sont incomplets et manquent d'informations. Ces articles sont marqués comme des stubs, ce qui signifie qu'ils sont suffisamment importants pour exister en tant que pages individuelles, mais qu'ils seront complétés plus tard. Si vous êtes familier avec le sujet de l'article, contribuez-y et partagez vos connaissances.

Inter-connexion

L'une des principales caractéristiques de tout wiki est la connectivité, c'est-à-dire que les articles renvoient à des pages connexes, ce qui aide le lecteur à rester dans le flux. Pour connecter les articles, ajoutez des liens vers les termes mentionnés lorsque cela est important pour une meilleure compréhension du sujet. Créez des liens vers des sections individuelles de l'article si nécessaire et utilisez les pages de désambiguïsation pour les termes généraux.

Nouveaux articles

osu! est un environnement en constante évolution : la communauté crée de nouvelles beatmaps, invente de nouvelles façons de s'exprimer et fait d'autres choses nouvelles. Si un certain événement ou terme n'est pas couvert, n'hésitez pas à écrire un article à ce sujet et à contribuer au réservoir de connaissances mondiales. Nouveau tournoi ou concours ? Une nouvelle fonctionnalité d'osu! ? Une partie inconnue de l'histoire du jeu ? Mettez vos talents de rédacteur à profit.

Mises à jour

Pour l'étendue possible du travail, voir : Liste des TODO non suivis (anglais)

Les articles existants ont également besoin d'être entretenus. Si vous avez trouvé une erreur factuelle, ou s'il manque des détails, ou si vous voulez simplement réécrire/étendre l'article en fonction de la réalité, avancez et faites du osu! wiki un meilleur endroit. Si le changement que vous envisagez est assez important ou significatif, assurez-vous de le soumettre à la discussion dans le canal #osu-wiki, ou créer un suivi de problèmes.