Dotclear

Vous n'êtes pas identifié(e).

Annonce

13 février 2024 Sortie de Dotclear 2.29

#1 2010-09-09 19:22:01

Kozlika
Modo dcTeam
Inscription : 2004-05-08
Site Web

Nommage des plugins

Attention la chieuse est de retour ;-)

Alors voilà. Je me suis occupée soit de rien soit de pas grand chose à part l'ergo depuis quelques mois. Tant et si bien que je n'ai pas suivi au jour le jour les nouveaux plugins sur le lab, dotaddict ou dans les fils de ce forum. Je suis très peu consommatrice de nouveautés donc sur un plan personnel je m'en fiche un peu, mais maintenant que je me réattache plus à lire le forum il m'arrive fréquemment de chercher si un plugin correspond à la demande d'un utilisateur.

Eh bien je vais vous dire : nous sommes trop drôles.

Si si. Mais vraiment TROP hein ? Je ne comprends pas la moitié du quart du douzième de ce que fait un plugin en lisant son nom… Et parfois la description ne suffit pas à vraiment comprendre de quoi t'est-ce donc qu'il s'agit. Les noms me font marrer mais je suis perdue !

J'ajoute que dans un louable souci d'internationalisation beaucoup d'entre nous/vous nomment leur plugin en anglais puis en parlent dans leur appellation traduite en français…

Sérieux, je sais bien que la sénilité me guette mais si même moi j'ai du mal à suivre le panorama des plugins, vous imaginez le débutant qui débarque ?

Vous avez une idée de comment on peut continuer à s'amuser sans pénaliser le chaland ?


La documentation : http://doc.dotclear.net/2.0/fulltoc
Le module de recherche du forum : http://www.dotclear.net/forum/search.php ?

Hors ligne

#2 2010-09-09 19:28:29

Moe
Responsable du mini-bar
Lieu : France
Inscription : 2004-09-19
Site Web

Re : Nommage des plugins

Huhu, je viens juste de publier un billet où je me suis amusé à utiliser les derniers noms improbables. :)

Comme tu le dis, le seul risque de donner un nom qui n'a aucun sens c'est que personne n'utilise le plugin. Si les développeurs l'ont décidé, je ne vois pas trop ce qu'on peut y changer. Qui serait prêt à renommer son plugin ?

Hors ligne

#3 2010-09-09 19:45:30

Jean-Michel
Modérateur à ailes d'ange
Lieu : Paris
Inscription : 2006-08-22
Site Web

Re : Nommage des plugins

Je t'appuie sur la double nomination des plugins avec un nom langue française et un nom en langue anglaise. Je trouve que ça ne rime à rien (pour l'utilisateur) surtout si on lui trouve une abréviation sympathique (et avec le temps, les utilisateurs finissent toujours par lui donner un surnom).

Même si c'est un cas à part, pour mes thèmes, je leur préfére un nom symbolique sinon je tomberai vite dans la numérotation avec mes initiales (déjà testé, ça le fait pas).

Là où il faut faire sérieusement un effort, c'est sur la rédaction de la description (il fait quoi mon plugin ? dans quel cas puis-je l'utiliser ?) et dans la documentation (développement des points précédents). Et surtout ne pas oublier qu'un utilisateur novice, débutant et confirmé peuvent me lire, comprendre et utiliser mon plugin.

Hors ligne

#4 2010-09-09 19:59:49

Dsls
Modérateur couteau-suisse
Inscription : 2004-11-18
Site Web

Re : Nommage des plugins

Je ne suis pas d'accord sur les noms de plugins. Autant je vous suis à 100% pur ce qui est du descriptif du plugin, autant il est "de coutume" de baptiser son plugin d'un nom. Les acronymes sont aussi monnaie courante, et n'ont pas toujours (voir rarement) un lien avec leur rôle. En tant que développeur de plugin, j'ai souvent bien du mal à trouver un nom pas trop long, pas déjà utilisé, et décrivant en plus ce que fait le plugin, ou alors vous aurez rapidement des plugins avec des noms à rallonge.

Un utilisateur sait en général se servir d'un moteur de recherche, et le matching de termes cherchés se fera sur la description du plugin, moins souvent son nom.

Pour ce qui est du bilinguisme des descriptions, je suis d'accord, il faudrait qu'on s'accorde pour pouvoir gérer des descriptions en français et en anglais. Personnellement, je m'attache à coder un plugin d'abord en anglais, et je le traduis au dernier moment...


Dyslexics have more fnu!

Hors ligne

#5 2010-09-09 20:01:26

osku
Membre
Lieu : 28
Inscription : 2005-06-15

Re : Nommage des plugins

Question bonus :
Faut-il nommer un plugin par le nom du répertoire (id) ou par le nom qui s'affiche dans la liste des extensions (name) ?

Beaucoup font le raccourci de prendre le nom du répertoire comme nom du plugin, c'est une mauvaise "pratique" qu'il faudrait corriger. il faut utiliser le nom.

Par exemple : l'extension « Private mode » ou en français « Mode privé » est souvent raccourcie au seul « private ».

Changeons nos habitudes pour changer les habitudes de chacun.

Hors ligne

#6 2010-09-09 21:24:49

JcDenis
Membre
Lieu : Lyon, France
Inscription : 2007-08-31
Site Web

Re : Nommage des plugins

A vrai dire, moi même je ne sais plus ce que font mes plugins quand je regarde le wiki du lab!

Mais une fois sur Dotaddict je m'efforce de traduire la ligne de description anglais/français ce qui donne déjà une bonne idée.
Après un pourquoi un plugin aurait-il un nom en rapport à sa fonction (qui donne souvent des noms à rallonge) alors qu'un thème peut s'appeler comme il veut...


Cordialement,
_JC | Intérimaire | En mode invisible

Hors ligne

#7 2010-09-09 21:31:56

Tomtom33
Responsable des travaux finis
Lieu : Barcelone
Inscription : 2006-06-13

Re : Nommage des plugins

Pas mieux que Dsls et JcDenis. Et puis, il faut pas oublier que nous sommes des geeks, barbus, klingons, etc.. On s'amuse comme on peut, il faut pas nous enlever ça, on va vraiment déprimer après! :D


Le lab => http://lab.dotclear.org
Besoin d'un plugin? => http://plugins.dotaddict.org
Besoin d'un thème? => http://themes.dotaddict.org
Besoin d'une astuce? => http://tips.dotaddict.org

Hors ligne

#8 2010-09-09 22:28:26

Black Angel
Membre
Inscription : 2008-05-11

Re : Nommage des plugins

Je viens m'exprimer en tant que non-plugineur.

J'aime bien les noms drôles, ça marque bien la mémoire. Par contre, il est vrai que je cherche parfois le plugin sous son nom " humoristique " et non son nom tel qu'affiché dans " Extensions ". C'est une problématique intéressante.

Je n'en cite qu'un parce que je l'ai sous les yeux : Templator. Dans "Extensions ", osku l'a baptisé " Plus de gabarits ", ce qui est extrêmement logique, vu que c'est sa fonction. Excellent pour l'utilisateur qui n'est pas le responsable de la plate-forme, mais l'admin lui se rappelle de Templator.
Donc petite idée en l'air : la possibilité de choisir le nom affiché, c'est-à-dire le nom du plugin ou sa fonction (3-4 mots). Comme ça, y a le choix selon les préférences de l'utilisateur et selon le plugin.

L'avantage du nom " humoristique ", c'est qu'il n'a pas besoin d'être traduit en plusieurs langues. Ca évite les confusions. Je prends le cas du plugin " Related Posts " appelé aussi " Billets connexes ". Il m'a fallu un peu de temps pour me dire que c'était le même plugin.

Pour ma part, j'aime bien avoir un exemple d'utilisation d'utilisation du plugin et si possible une démo sur le blog de l'auteur. Si ce n'est pas le cas, j'attends souvent de voir si d'autres l'ont exploité et comment. Que voulez-vous, je suis lent à la comprenaille.

En tout cas, c'est une discussion intéressante.

Hors ligne

#9 2010-09-10 06:20:18

Dsls
Modérateur couteau-suisse
Inscription : 2004-11-18
Site Web

Re : Nommage des plugins

Ne vous méprenez pas dans mes derniers propos : on est tous d'accord pour dire qu'il y a un problème quelque part, je pense juste que le coupable désigné n'est pas le bon (ie. le nom du plugin).
En dehors du monde dotclear, le nombre de noms d'applications n'ayant pas de lien direct avec leur rôle est loin d'être dérisoire. Dans le monde du libre, on croule souvent sous les acronymes. Ex : GIMP (Gnu Image Manipulation Program), GNOME, KDE, GNU (GNU's Not Unix), sans compter les YA* (Yet Another ... : YASH, YAVR, ...). Quitte à avoir un acronyme, autant en avoir un qui sonne bien.

Il n'est pas toujours aisé de trouver un nom de plugin parlant, et pire, ça peut poser problème :
* un nom court ne décrit pas forcément bien le plugin
* on risque d'avoir N noms quasi identiques : MyImageManager, GalerieDePaul, SuperGalerie, ThumbsGallery. Je doute qu'avoir des noms proches aide plus à s'y retrouver.

Revenons au coeur du problème, ou plutôt des problèmes.

Je suis d'accord avec Osku, le nom d'un plugin ne doit pas forcément apparaître tous les jours dans l'admin du blog. Je crois d'ailleurs que c'est déjà le cas pour la majorité. Ex : le plugin meuh n'affiche à aucun endroit "meuh", il ajoute bien une section "historique des URLs" dans un billet. Le champ dans dc_post créée par Grumph est post_res. Je plaide coupable pour la présence du mot "grumph" dans la barre de gauche de l'admin, mais je ne voyais pas quel nom mettre. En clair, si on avait pu étendre via un plugin la partie "maintenance", je l'aurais mis là. (Voyez là un coup de boost pour le ticket correspondant, voire un appel du pied pour la refonte de l'admin :)

Concernant le descriptif du plugin, c'est un peu notre faute, (nous=daTeam/dcTeam). On n'a pas donné de ligne directrice pour décrire son plugin (ou ça m'a échappé), du coup chacun a fait comme il le sentait. Ce serait peut-être l'occasion de mettre les choses à plat, et de poser les règles d'inscription des plugins avec la langue à utiliser.

A coté de ça, je plaide pour l'ajout d'un répertoire info (ou autre chose, pourquoi pas le retour d'un desc.[lang].xml) dans chaque plugin, où da pourrait piocher directement le descriptif court et long dans la langue voulue, les tags à mettre en place, ... on pourrait même faire un plugin qui permette d'aider à renseigner ces fichiers, voire lancer un appel à traducteurs pour les non-anglophones d'entre nous.


Dyslexics have more fnu!

Hors ligne

#10 2010-09-10 06:25:32

Dsls
Modérateur couteau-suisse
Inscription : 2004-11-18
Site Web

Re : Nommage des plugins

Dernier point : j'en ai fini avec le onomatopées pour ma part, le prochain plugin aura un nom _un peu_ plus parlant. Il sera peut-être dévoilé au dotCamp, si je règle les derniers soucis techniques. Ce sera un plugin sans admin, sans widgets, sans urlhandler, mais pas simple pour autant (et il sera bien klingon comme il faut dans le code). Stay tuned :)


Dyslexics have more fnu!

Hors ligne

#11 2010-09-10 07:27:42

annso
Responsable de la machine à Twix
Lieu : Lyon
Inscription : 2006-03-05
Site Web

Re : Nommage des plugins

Dsls a écrit :

Dernier point : j'en ai fini avec le onomatopées pour ma part, le prochain plugin aura un nom _un peu_ plus parlant. Il sera peut-être dévoilé au dotCamp, si je règle les derniers soucis techniques. Ce sera un plugin sans admin, sans widgets, sans urlhandler, mais pas simple pour autant (et il sera bien klingon comme il faut dans le code). Stay tuned :)

C'est du gros méchant teasing ça, je croyais que c'était interdit pas la loi !

Hors ligne

#12 2010-09-10 07:34:17

Kozlika
Modo dcTeam
Inscription : 2004-05-08
Site Web

Re : Nommage des plugins

Je l'avais bien entendu comme ça, Dsls, pas plus que je ne souhaite nous voir devenir de vieux rabougris trop sérieux !

Simplement, puisque pour toutes les raisons invoquées fort justement par vous tous, le nom ne peut être limpide, alors il nous faut soigner les infos données par ailleurs. J'entends par là :

* une description claire, bilingue quand ça peut (Dsls je te soutiens dans ta proposition de desc.[lang].xml
* un soin particulier sur la fiche DA : description plus longue, exemples, démos avec le souci d'être compris de tous et pas seulement de ses pairs
* la mention sur la fiche du nom du répertoire (particulièrement souhaitable quand le nom du répertoire ne ressemble ni au nommage ni à l'intitulé dans l'admin !)

Je sais que ça gave souvent les dév de s'occuper de toutes ces choses périphériques (et je ne parle même pas de doc), mais le lab devrait/pourrait servir aussi à ça : nous sommes quelques-uns j'en suis sûre qui serions prêts à collaborer sur ces aspects aux dev qui en feraient la demande.

Et pour balayer devant ma propre porte, même s'il ne s'agit pas de plugins, j'ai moi même ce travers quand je rédige (il serait plus juste de le conjuguer à l'imparfait, mais bon) des tutos. Je m'efforce dorénavant de prendre garde aux titres ou si le titre est une pitrerie je m'oblige dès le chapo à clarifier l'objet du tuto.


La documentation : http://doc.dotclear.net/2.0/fulltoc
Le module de recherche du forum : http://www.dotclear.net/forum/search.php ?

Hors ligne

#13 2010-09-10 07:42:42

Dsls
Modérateur couteau-suisse
Inscription : 2004-11-18
Site Web

Re : Nommage des plugins

Kozlika a écrit :

* une description claire, bilingue quand ça peut (Dsls je te soutiens dans ta proposition de desc.[lang].xml
* un soin particulier sur la fiche DA : description plus longue, exemples, démos avec le souci d'être compris de tous et pas seulement de ses pairs
* la mention sur la fiche du nom du répertoire (particulièrement souhaitable quand le nom du répertoire ne ressemble ni au nommage ni à l'intitulé dans l'admin !)

Je vois là un 3-en-1. On peut très bien envisager un desc.[lang].xml auto-suffisant qui contienne aussi la fiche DA. Je vais ouvrir un fil à  part pour traiter ce sujet, je pense qu'il y a vraiment quelque chose à faire ce niveau-là.


Dyslexics have more fnu!

Hors ligne

#14 2010-09-10 08:00:17

Tomtom33
Responsable des travaux finis
Lieu : Barcelone
Inscription : 2006-06-13

Re : Nommage des plugins

Dsls a écrit :
Kozlika a écrit :

* une description claire, bilingue quand ça peut (Dsls je te soutiens dans ta proposition de desc.[lang].xml
* un soin particulier sur la fiche DA : description plus longue, exemples, démos avec le souci d'être compris de tous et pas seulement de ses pairs
* la mention sur la fiche du nom du répertoire (particulièrement souhaitable quand le nom du répertoire ne ressemble ni au nommage ni à l'intitulé dans l'admin !)

Je vois là un 3-en-1. On peut très bien envisager un desc.[lang].xml auto-suffisant qui contienne aussi la fiche DA. Je vais ouvrir un fil à  part pour traiter ce sujet, je pense qu'il y a vraiment quelque chose à faire ce niveau-là.

Je tiens quand même à préciser que si on a mis en place un système de soumission par formulaire sur DA, c'est justement parce que donner toutes les infos dans un fichier était trop lourd pour les développeurs (ça les gave) et trop ouvert/permissif pour les diverses validations.

On en a d'ailleurs discuté plus d'une fois et tout le monde s'est mis d'accord sur le système actuel.


Le lab => http://lab.dotclear.org
Besoin d'un plugin? => http://plugins.dotaddict.org
Besoin d'un thème? => http://themes.dotaddict.org
Besoin d'une astuce? => http://tips.dotaddict.org

Hors ligne

#15 2010-09-10 08:06:18

Dsls
Modérateur couteau-suisse
Inscription : 2004-11-18
Site Web

Re : Nommage des plugins

Tomtom: j'ai mis mes idées à plat là-bas. N'y vois pas une critique de l''énorme boulot que vous avez fait sur DA, je cherche juste à proposer des évolutions qui conviendront de chaque coté, niveau contributeurs, et daTeam :)


Dyslexics have more fnu!

Hors ligne

#16 2010-09-10 08:15:17

Tomtom33
Responsable des travaux finis
Lieu : Barcelone
Inscription : 2006-06-13

Re : Nommage des plugins

Dsls a écrit :

Tomtom: j'ai mis mes idées à plat là-bas. N'y vois pas une critique de l''énorme boulot que vous avez fait sur DA, je cherche juste à proposer des évolutions qui conviendront de chaque coté, niveau contributeurs, et daTeam :)

Je n'y vois pas de critique, j'ai simplement précisé pourquoi le système actuel est comme il est :)


Le lab => http://lab.dotclear.org
Besoin d'un plugin? => http://plugins.dotaddict.org
Besoin d'un thème? => http://themes.dotaddict.org
Besoin d'une astuce? => http://tips.dotaddict.org

Hors ligne

#17 2010-09-10 08:48:26

Kozlika
Modo dcTeam
Inscription : 2004-05-08
Site Web

Re : Nommage des plugins

Dans un fichier, peut être trop lourd, dans une interface de soumission *depuis son blog de dev* ça pourrait le faire, nan ? dit celle qui ne saurait pas en coder la première ligne…


La documentation : http://doc.dotclear.net/2.0/fulltoc
Le module de recherche du forum : http://www.dotclear.net/forum/search.php ?

Hors ligne

#18 2010-09-10 09:12:42

JcDenis
Membre
Lieu : Lyon, France
Inscription : 2007-08-31
Site Web

Re : Nommage des plugins

Kozlika a écrit :

Dans un fichier, peut être trop lourd, dans une interface de soumission *depuis son blog de dev* ça pourrait le faire, nan ? dit celle qui ne saurait pas en coder la première ligne…

Hum, j'aime bien cette idée. Soumettre depuis son blog


Cordialement,
_JC | Intérimaire | En mode invisible

Hors ligne

#19 2010-09-10 09:23:02

Dsls
Modérateur couteau-suisse
Inscription : 2004-11-18
Site Web

Re : Nommage des plugins

Kozlika a écrit :

Dans un fichier, peut être trop lourd, dans une interface de soumission *depuis son blog de dev* ça pourrait le faire, nan ? dit celle qui ne saurait pas en coder la première ligne…

Lourd, pas forcément. L'avantage du fichier est qu'il est embarqué dans le plugin. Et donc versionné sur le lab.
On peut aussi envisager de "purger" le plugin en virant a posteriori ces fichiers, si on souhaite économiser de la place...


Dyslexics have more fnu!

Hors ligne

#20 2010-09-10 09:24:09

Kozlika
Modo dcTeam
Inscription : 2004-05-08
Site Web

Re : Nommage des plugins

Tout dépend de ce qu'on met sur ce fichier. Tu fais comment pour les screenshots ? (si ça doit servir aussi à remplir la fiche DA)


La documentation : http://doc.dotclear.net/2.0/fulltoc
Le module de recherche du forum : http://www.dotclear.net/forum/search.php ?

Hors ligne

#21 2010-09-10 09:27:12

Dsls
Modérateur couteau-suisse
Inscription : 2004-11-18
Site Web

Re : Nommage des plugins

Kozlika a écrit :

Tout dépend de ce qu'on met sur ce fichier. Tu fais comment pour les screenshots ? (si ça doit servir aussi à remplir la fiche DA)

Dans un répertoire dédié du plugin (doc, par exemple, qui pourrait aussi contenir les desc.xml).

Et personnellement, tant que je n'ai pas soumis le plugin sur DA, j'aime bien pouvoir travailler hors web. Enfin, "j'aime bien" ... dans le train, la 3G et/ou le wifi passent mal, ce serait dommage de devoir être connecté au web pour agir sur le formulaire.

D'autant plus que le faire dans un fichier, offline, ça éviterait d'incessants aller-retours vers une ihm distante (qui devrait qui plus est implémenter un mode d'édition). La gestion des soumissions sur DA serait moins impactée...


Dyslexics have more fnu!

Hors ligne

#22 2010-09-10 10:15:28

Kozlika
Modo dcTeam
Inscription : 2004-05-08
Site Web

Re : Nommage des plugins

Ah non je ne pensais pas à un formulaire distant, je pensais à une interface embarquée comme packager (avec lui, même) en tant que plugin de ton install de dev et quand ton ploug est prêt, hop ça package et ça soumet (optionnellement) à DA.


La documentation : http://doc.dotclear.net/2.0/fulltoc
Le module de recherche du forum : http://www.dotclear.net/forum/search.php ?

Hors ligne

#23 2010-09-10 10:24:55

Dsls
Modérateur couteau-suisse
Inscription : 2004-11-18
Site Web

Re : Nommage des plugins

Ok, je crois qu'on parle donc de la même chose, ou presque :)


Dyslexics have more fnu!

Hors ligne

#24 2010-09-10 11:47:41

Jean-Michel
Modérateur à ailes d'ange
Lieu : Paris
Inscription : 2006-08-22
Site Web

Re : Nommage des plugins

Je vois que la conversation a bien avancé, je n'y vois rien à ajouter ;-)

Black Angel a écrit :

Pour ma part, j'aime bien avoir un exemple d'utilisation d'utilisation du plugin et si possible une démo sur le blog de l'auteur. Si ce n'est pas le cas, j'attends souvent de voir si d'autres l'ont exploité et comment. Que voulez-vous, je suis lent à la comprenaille.

Pour leur défense (enfin, c'est mon avis), créer un blog démo vraiment performant (dans le sens : permettant de tester du plus simple au plus confirmé), ça prend du temps. C'est pas impossible, juste que ça nécessite une longue réflexion ;-)

Hors ligne

#25 2010-09-10 12:39:50

Black Angel
Membre
Inscription : 2008-05-11

Re : Nommage des plugins

J'en conviens totalement. Disons que ça fait partie des petits plus agréables. ;-)

Hors ligne

Vous n'êtes pas identifié(e).

Pied de page des forums

Sites map