Page d’aide de l’application Slack

Obtenir de l’aide

Lorsque vous utilisez l’application Open Agora dans Slack, cette dernière affiche un ensemble de messages qui contiennent beaucoup de boutons. À tout moment si vous avez une hésitation, pensez à utiliser le bouton d’aide : Capture du bouton d’aide de Open Agora Ce bouton affiche des informations concernant les autres boutons du message actuel.

Si cela ne suffit pas, ou que vous rencontrez un problème dans l’utilisation de l’application, n’hésitez pas à contacter notre équipe. Vous pouvez également utiliser la commande /poll feedback votre feedback/question/demande directement dans Slack.

Foire aux questions (FAQ)

  1. Comment créer une consultation ?
  2. Comment voter ? Comment modifier mon vote ?
  3. Est-il possible de visualiser le résultat pendant que la consultation se déroule ?
  4. Est-il possible de savoir pour quels choix chaque participant a voté ?
  5. Est-il possible de créer plusieurs consultations dans un même canal (privé) ?
  6. Que signifie la mention « Condorcet » dans l’affichage du résultat ?
  7. Quel est le sens des scores affichés avec le résultat Condorcet ?
  8. Est-il possible de restreindre la commande /poll à un certain groupe d’utilisateurs ?
Question 1 : Comment créer une consultation ? Retour

Il faut réaliser les opérations suivantes:

  1. Écrire /poll new "Intitulé de votre consultation" "Un premier choix" "Un second choix"
    Dans cette commande, "new" est optionnel. On obtient alors l'affichage suivant : Capture de la commande "new" de Open Agora dans Slack
  2. Ensuite, il est possible d'afficher la consultation pour tous les membres du canal en cliquant le bouton Publish ou en saisissant : /poll publish
    On obtient l'affichage suivant : Capture de la commande "publish" de Open Agora dans Slack Ce message est le centre de toutes les interactions avec votre consultation : il est possible de créer votre vote (ou de le modifier) ou de visualiser le résultat en cours de consultation en utilisant les boutons correspondants.
  3. Ensuite, de façon optionnelle, chaque membre du canal peut ajouter des choix en utilisant :
    /poll add Un autre choix, "Un choix, avec une virgule", Encore un autre choix
    (les choix sont séparés par des virgules, cette opération peut être répétée à plusieurs reprises)
  4. Éventuellement, le créateur de la consultation peut supprimer des choix en utilisant: /poll remove 3 (où 3 est le numéro du choix à supprimer).
Question 2 : Comment voter ? Comment modifier mon vote ? Retour

Pour voter, il suffit de cliquer sur le bouton Vote! dans le message publié, il est également possible de saisir : /poll vote : Capture de la commande "publish" de Open Agora dans Slack (avec le bouton de vote button mis en valeur)

Ceci provoque l'apparition d'un message personnel de vote, similaire à celui-ci: Capture du message de vote (1) En cliquant sur les boutons des choix, vous choisissez vos préférences de premier rang (Rank 1). Il s'agit de vos choix préférés.

Dès que vous avez retenu au moins un choix, vous pouvez positionner d'autre choix pour les rangs suivants en utilisant le bouton + Add rank : Capture du message de vote (2) Ce bouton crée un nouveau rang.
Attention : il ne peut pas y avoir de rang sans aucun choix sélectionné (si vous placez des choix aux rangs 1 et 3, en l'absence de choix au rang 2, votre vote aurait le même effet que s'ils étaient aux rangs 1 et 2), si jamais vous supprimez à un moment tous vos choix à un certain rang, l'application compactera automatiquement les rangs de vos choix.

Une fois que vous avez sélectionné des choix sur plusieurs rangs, vous pouvez vous déplacer entre les rangs en utilisant les boutons directs, et modifier votre vote si vous le souhaitez. Capture du message de vote (3)

Question 3 : Est-il possible de visualiser le résultat pendant que la consultation se déroule ? Retour

Oui ! Vous devez simplement utiliser le bouton Result dans le message de publication, ou bien saisir /poll result: Capture du message "publish" dans Slack (avec le bouton "Result" mis en valeur) Ceci affichera le message de résultat suivant : Capture du message "result" dans Slack (Condorcet)

Dans la capture ci-dessus, Condorcet présente un classement des choix à partir du plus consensuel, en prenant en compte tous les rangs exprimés par chacun des votants.
(pour plus de détails, consultez la FAQ sur le système de vote Condorcet)

En utilisant le bouton Majority (ou en saisissant /poll result -majority), on obtient le message suivant : Capture du message "result" dans Slack (majorité - batons) Ce décompte ne présente que la somme des premières positions recueillies par chacun des choix. Lorsque les votants expriment des choix avec plusieurs rangs, le résultat Condorcet est plus précis (voir ci-dessous). Dans notre exemple, trois choix obtiennent des scores égaux dans le cas majoritaire alors que Condorcet indique que le Choix 2 est le plus favorable avec un taux d'approbation minimal de 60 %.

En utilisant le bouton Pie (ou en saisissant /poll result -majority -pie) on obtient : Capture du message "result" dans Slack (majorité - circulaire)

Lorsque la consultation est non-anonyme, en utilisant le bouton Voters (ou en saisissant /poll voters -l) on obtient le détail des votes de chacun des votants : Capture du message "result" dans Slack (avec affichage de chacun des votes)

Lorsque la consultation est non-anonyme, en utilisant le bouton Details (ou en saisissant /poll result -l) on obtient, pour chaque choix, la liste des votes obtenus: Capture du message "result" dans Slack (avec affichage de chacun des votes pour chaque choix)

Question 4 : Est-il possible de savoir pour quels choix chaque participant a voté ? Retour

Utiliser le bouton Voters dans le message de résultat (ou saisir /poll voters -l) : Capture du message "result" dans Slack (Condorcet) produit le détail des votes de chacun des votants : Capture du message "result" dans Slack (avec affichage de chacun des votes)

Utiliser le bouton Details (ou saisir /poll result -l) produit, pour chaque choix, la liste des votes obtenus: Capture du message "result" dans Slack (avec affichage de chacun des votes pour chaque choix)

Question 5 : Est-il possible de créer plusieurs consultations dans un même canal (privé) ? Retour

Actuellement, ce n'est pas possible. Nous pensons qu'introduire cette possibilité augmenterait considérablement la complexité d'utilisation de notre application. Cependant, il est déjà possible de créer de nouveaux canaux pour accueillir d'autres consultations.

Question 6 : Que signifie la mention « Condorcet » dans l’affichage du résultat ? Retour

Les votants peuvent classer leur choix par ordre de préférence (le premier choix étant le choix préféré). La Méthode Condorcet est une solution pour prendre en compte les préférences de l'ensemble des votants.

Lorsque ces deux résultats diffèrent, le gagnant Condorcet constitue un meilleur choix que celui du scrutin majoritaire. Considérons un scrutin qui propose trois choix : A, B et C, à 16 votants qui sont invités à classer ces choix selon leurs préférences. On obtient les résultats suivants :

  • 5 votants classent A avant B avant C;
  • 7 votants C avant B avant A;
  • 4 votants B avant A avant C.

Le gagnant majoritaire est C qui obtient 7 voix (contre 5 pour A et 4 pour B). Le gagnant Condorcet est B pour les raisons qui suivent :

  • B est placé avant A 11 fois (7 CBA et 4 BAC), A est placé avant B 5 fois (5 ABC), donc B est un meilleur choix que A.
  • B est placé avant C 9 fois (5 ABC et 4 BAC), C est placé avant B 7 fois (7 CBA), donc B est un meilleur choix que C.

En outre, la méthode Condorcet est, en général, efficace pour rompre les égalités dans les petits groupes et lorsque ce n'est pas le cas, les solutions sont alors réellement équivalentes aux yeux des votants. Ce phénomène est illustré par les captures de cette question. Le suffrage majoritaire produit trois choix placés à égalité, alors que le résultat Condorcet place le choix B en première position.

Pour trouver le vainqueur Condorcet, nous utilisons la méthode de Schulze. Cette méthode permet de départager des gagnants dans certains cas d'égalité.

Si vous souhaitez approfondir sur la méthode Condorcet, n'hésitez pas à lire notre article de blog sur ce sujet.

Question 7 : Quel est le sens des scores affichés avec le résultat Condorcet ? Retour

Examinons les résultats suivants: Capture du message "result" dans Slack (Condorcet)

Le choix 2 est le vainqueur Condorcet, cela signifie qu'il est meilleur que tous les autres choix pour les votants. De plus il possède un taux de satisfaction minimal de 60 %: il obtient au moins 60 % de victoires contre chacun des autres choix.

Les choix 3 et choix 4 sont deuxièmes dans la liste Condorcet, cela signifie qu'ils sont meilleurs que tous les autres choix, à l'exception du choix 2. De plus ils possèdent un taux de satisfaction minimal de 59 %: ils obtiennent au moins 59 % de victoires contre chacun des autres choix (à l'exception de chacun d'eux et du choix 2).

Les choix 1 et choix 6 sont troisièmes dans la liste Condorcet, ils sont meilleurs que le dernier choix restant (5). Ils obtiennent un score de 58 %, ce qui signifie qu'ils gagnent au moins 58 % du temps contre le choix 5.

Le choice 5 est le plus mauvais choix possible pour les votants, il a un score de 0.

Attention : ces scores reflètent l'approbation d'un choix donné par rapport aux choix moins bien classés. Leur total ne fait pas 100, c'est normal.

Question 8 : Est-il possible de restreindre la commande /poll à un certain groupe d’utilisateurs ? Retour

Oui, pour réaliser ce type de restriction il est nécessaire d'utiliser un canal privé et d'y tenir les consultations sensibles.

Commandes de base

Commande Description
/poll [new] poll_name [choice1 ...] Création d’une nouvelle consultation (maximum 1 consultation active par canal), décrite par nom_consult avec quelques choix initiaux. Il est possible d’utiliser des guillemets (") pour délimiter le nom de la consultation ou un choix.
Exemple:
/poll "Choisissez une couleur" bleu "vert clair" "RGB(255,0,0)"
/poll add choice1 [, choice2, ...] Ajout d’un choix supplémentaire pour la consultation en cours (peut être utilisé plusieurs fois de suite). Vous pouvez utiliser des guillemets (") pour délimiter ces choix (en particulier lorsqu’ils contiennent des virgules).
/poll publish [result] Réalise la publication de la consultation en cours dans le canal, ainsi que tous les choix possibles qui lui sont attachés. Tous les membres du canal voient cette publication.
Si la commande est appelée avec le paramètre result, les résultats actuels de la consultation sont affichés.
/poll show Affichage privé de la consultation active dans le canal. Il est possible de cliquer directement dans l’affichage pour voter. Cette commande a le même effet que cliquer sur bouton Vote dans le message obtenu avec /poll publish.
/poll vote num1 ..., num2 num3 ... Envoi d’un nouveau vote pour certains choix, classés par ordre décroissant de préférence. Les utilisateurs de l’application sont autorisés à voter plusieurs fois, le nouveau vote remplaçant le précédent (plus de détails dans la FAQ).
Si jamais la commande est appelée sans argument, produit l’affichage du vote actuel avec les boutons de vote comme avec /poll show.
/poll result [-majority [-pie]] [-l/-v] [publish] Affichage privé du résultat actuel pour la consultation en cours dans le canal.
Par défaut le résultat Condorcet est affiché, l’option "-majority" entraîne l’affichage du résultat « majoritaire ». Dans ce cas, les résultats sont affichés sous la forme d’un histogramme (diagramme en bâtons), qui peut être remplacé par un diagramme circulaire en utilisant l’option "-pie".
Utiliser l’option "publish" permet de publier le résultat pour l’ensemble du canal. Les options "-l/-v" permettent, lorsque la consultation est non-anonyme, de visualiser l’ensemble des choix de chacun des votants.
Note : le message affiché par la commande contient des boutons qui permettent de basculer simplement entre les différents affichages.
/poll close [-l/-v] [-silent] Ferme la consultation en cours : il n’est plus possible de voter, le résultat final est affiché (pour tous les membres du canal).
Lorsque la consultation est non-anonyme et qu’une option -l/-v est utilisée, affiche également l’ensemble des choix de chacun des votants.
L’option -silent permet la fermeture du sondage sans produire d’affichage pour l’ensemble du canal.
/poll help command Aide détaillée sur command (en anglais).
/poll help [-a] Affiche la liste des commandes simples, et leur documentation en anglais. L’option -a provoque l’affichage des commandes avancées.

Commandes avancées

Commande Description
/poll create poll_name Obsolète, utiliser /poll new ... de préférence.
Création d’une nouvelle consultation (maximum une consultation par canal), décrite par nom_consult, sans aucun choix initial.
/poll remove num1 [num2 ...] Supprime les choix d’indices num1 num2 ... et tous les votes qui leurs sont associés. Seul le créateur de la consultation peut effectuer cette suppression.
/poll voters [-l] Affiche la liste des utilisateurs qui ont déjà émis un vote pour la consultation active dans le canal.
L’option -l entraîne un affichage vertical (sous forme d’une liste) ; lorsque la consultation est non-anonyme, cette option déclenche l’affichage de l’ensemble des choix de chacun des votants.
/poll anon[ymous] Rend la consultation en cours anonyme : personne (pas même le créateur de la consultation) ne peut connaître les votes de chacun. Seul le créateur peut utiliser cette commande, de plus il n’est pas possible de revenir sur l’application de cette commande.
/poll open Provoque la réouverture de la dernière consultation fermée dans le canal. Cette opération n’est possible que lorsqu’il n’y a pas de consultation active dans le canal.
/poll delete Détruit définitivement une consultation fermée, ainsi que le résultat associé.
/poll feedback feedback text Envoie un message à l’équipe d’Open Agora : des dysfonctionnements, suggestions, remerciements, tous vos commentaires sont bienvenus.