Discussion Projet:Infobox/Lua/Documentation

Documentation des filtrages par rang et par date

Pour les descriptions des paramètres des infobox, j’ai trouvé dans une documentation d’un module un paragraphe que je trouve assez utile, et qui décrit la manière dont sont sélectionnées les valeurs depuis wikidata en fonction du paramètre rank du module:Wikidata (preferred, normal, deprecated, valid, best). Dans la documentation du module:Infobox/Fonctions/Logiciel que je réalise, j’y ajoute une ligne pour expliquer le paramètre atdate=today.

Le but est de préciser le paragraphe sur les qualificatifs temporels (seule la ligne « de n'afficher que la valeur actuelle d'une propriété » est utile dans mon cas) et d’expliciter quels rangs sont pris en compte (j’ai des propriétés où seul le rang preferred est considéré, d’autres où c’est seulement le rang normal, et pour la plupart j’utilise le rang best).

Pensez-vous qu’il faille le préciser à chaque fois dans la colonne description éventuellement via un modèle (qui pourrait prendre deux paramètres, un pour le rank, et un pour atdate), ou bien q’une icône similaire à celle de {{Qualificatifs temporels}} dans la colonne Wikidata, assortie d’un lien vers un paragraphe plus complet seraient préférables (mais je vois mal comment en faire un qui prenne en compte tout ça à la fois) ?

Le paragraphe que j’ai ressemble à ça :

Lorsque des propriétés de Wikidata sont utilisées la ou les valeurs s'affichent en respectant les règles suivantes, dans l'ordre, jusqu'à ce qu'il soit possible de renvoyer quelque chose à afficher :

1. les valeurs qui ont un qualificatif P582 (« date de fin ») se référant au passé ne sont jamais prises en compte.
2. les valeurs ayant un rang égal à deprecated ne sont jamais prises en compte.
3. pour une catégorie de valeurs, celles ayant un rang normal ne sont prises en considération que s'il n'y en a aucune ayant un rang preferred.

— Metamorforme42 (discuter) 25 novembre 2022 à 21:33 (CET)

Bonjour Metamorforme42
Je pense comme toi qu'il faudrait mentionner dans plusieurs cas, comment le rank est pris en compte. Par ailleurs, la prise en compte des qualificatifs temporels se fait différemment suivant les propriétés : affichage de la dernière valeur, affichage de la valeur actuelle, affichage des dernières valeurs classées, affichages des périodes classées, … . Mais j'ajouterais aussi la langue qui intervient aussi en conjonction avec la langue comme pour la fonction website(). Pour le moment, je n'en vois pas d'autres. En combinant deux le comportement devient assez rapidement complexe et je ne vois pas d'autres solutions que de l'expliquer au cas par cas dans la description. Lors de l'introduction de {{Qualificatifs temporels}} mon idée était principalement d'éviter les répétitions et donc d'alléger les tableaux pour les lecteurs. Dans l'état actuel, il est sans doute nécessaire de :

1. rédiger des paragraphes spécifiques pour rank et P407 (« langue de l'œuvre, du nom ou du terme ») pour expliquer le comportement par défaut.
2. Introduire un ou des modèles pour signaler que ces qualificatifs interviennent de manière non standard ou coordonnée entre eux pour sélectionner les valeurs à afficher. J'avoue que ce n'est pas très clair dans mon esprit.
3. Améliorer {{Qualificatifs temporels}} pour qu'il soit plus précis en fonction des différentes situations que je listais plus haut.

--Dom (discuter) 26 novembre 2022 à 10:54 (CET)

1. 1. Pour le filtrage par rangs : dans le même esprit que pour {{Qualificatifs temporels}}, on pourrait avoir un paragraphe qui vient expliquer les uniquement les différents rangs, avec les 5 cas de figure possibles, et un modèle {{Filtrage par rang|rang=}} qui afficherait quel rang est filtré (par exemple: rang préféré uniquement, rang normal uniquement, rang obsolète uniquement, rang valide uniquement, meilleur rang uniquement), ainsi qu’un lien vers ce paragraphe.
   2. Pour le filtrage par langues avec P407 (« langue de l'œuvre, du nom ou du terme ») : on pourrait avoir un {{Filtrage par langue}} qui afficherait avec un lien vers un paragraphe qui explique le filtrage par langue.
2. Pour les traitements vraiment particuliers, je pense qu’il vaut mieux décrire au cas par cas. J’ai quelques exemples (pas encore documentés, mais c’est en cours) : une fonction qui affiche au maximum n langues, et sinon affiche « Multilingue » et peut rajouter « dont le français » si c’est le cas (Module:Infobox/Fonctions/Logiciel/Documentation#p.internationalisation(nbmax) ; une fonction qui affiche uniquement la valeur ayant un qualificatif défini à une valeur bien précise (Module:Infobox/Fonctions/Logiciel/Documentation#p.firstVersion()), des fonctions qui filtres les valeurs à afficher en fonction de la valeur d’un qualificatif qui doit être ou non dans une liste (Module:Infobox/Fonctions/Logiciel/Documentation#p.lastStableVersion() et Module:Infobox/Fonctions/Logiciel/Documentation#p.advancedVersion() ; une fonction où certaines valeurs définies dans une liste ne sont jamais affichées (Module:Infobox/Fonctions/Logiciel/Documentation#p.softwareType()). Avoir un modèle {{Filtrage particulier|lien paragraphe=}} qui affiche «  filtrage particulier » avec un lien vers un paragraphe explicatif personnalisé pourrait alléger les tableaux.
3. Pour l’amélioration de {{Qualificatifs temporels}}, peut-être que l’on pourrait associer à l’icône de calendrier une icône secondaire qui permettrait de spécifier à quels cas de figure on fait référence. Quelques idées : pour l’ajout de dates entre parenthèses, pour le classement par dates, pour le filtrage par date. Et on peut les faire suivre de quelques mots comme « valeur la plus récente uniquement », « valeurs avec une date uniquement », « valeurs actuelles uniquement » pour les filtrage ; et « valeurs les plus récentes en premier », « valeurs les plus anciennes en premier » pour le classement.

— Metamorforme42 (discuter) 26 novembre 2022 à 12:18 (CET)

@Metamorforme42

• Pour le 1.1, je suis d'accord et le pictogramme pour indiquer qu'il s'agit d'un filtrage me semble très clair.
• Pour le 1.2, je suis d'accord pour le modèle et les pictogrammes qui me semblent appropriés.
• Pour le 2, je suis d'accord qu'il y a de nombreux cas spécifiques de filtrage, je pense en particulier au module Infobox/Organisation qui exclut certaines valeurs pour les propriétés P31 (« nature de l’élément ») et P101 (« domaine d'activité »), P452 (« secteur d'activité économique »), P2650 (« intéressé(e) par »). Je pense que dans ces cas il faut décrire le comportement dans la colonne description. Je ne pense pas qu'un modèle apporte beaucoup dans ce cas.
• Pour le 3, l'idée d'accoler plusieurs pictogrammes pour préciser le fonctionnement dans les cas les plus courants me semble excellente. Je pense qu'il faut la tester avec des cas concrets pour éventuellement l'améliorer puis la généraliser aux autres types de filtrage. Ce qui donnerait : <pictogramme du type de filtrage (rang , date , langue , ...)> <action (affichage , tri , filtrage uniquement , … )>. Toutes les combinaisons ne sont pas possibles, mais chaque pictogramme aurait une signification précise dans ce contexte.

--Dom (discuter) 26 novembre 2022 à 20:44 (CET)

Les pictogrammes que tu as trouvé pour l’affichage et pour les rangs me semblent bien choisis. Je vais essayer de faire des tests prochainement, et avec des exemples issus de fonctions existantes : comme ça on verra mieux si ça fonctionne bien et si c’est compréhensible facilement ou s’il y a des points à revoir. — Metamorforme42 (discuter) 26 novembre 2022 à 22:59 (CET)

@Metamorforme42 Je vais essayer de tester de mon côté.

--Dom (discuter) 27 novembre 2022 à 00:15 (CET)

Bonjour Metamorforme42
J’ai mis en place une section « standard » pour le rang dans la documentation de l'infobox Organisation2 pour débuter ce test. Lorsque ce sera un peu plus abouti, il faudra le déplacer dans Projet:Infobox/Lua/Documentation pour pouvoir le réutiliser.

J'ai re-découvert à cette occasion la richesse des déclarations possibles utilisable par filterclaims.

--Dom (discuter) 1 décembre 2022 à 19:28 (CET)

Super :) de mon côté, je n’ai pas encore eu le temps d’avancer, mais je pense pouvoir en trouver fin de semaine prochaine. — Metamorforme42 (discuter) 1 décembre 2022 à 21:24 (CET)