A help button could be useful either way
15 « J'aime »
We had this button on Stack Overflow and the analytics / data showed that almost nobody used it. That does not mean it should not exist, of course, but the general rule is that the type of people you would want to use this button, pretty much never do.
4 « J'aime »
Stack Overflow seems way more aggressive these days for brand new users and audience for Discourse is way wider so this kind of approach may be applicable
I think there is definite value in giving some extra tips for tl0/tl1 that are getting accustomed and also for more advanced users that are looking for secret magic.
I guess what I want a little is a help mode that goes away after a bit
6 « J'aime »
To be fair, there is a plugin that sort of permits this already and I don’t think a lot of people use it…
https://github.com/cpradio/discourse-plugin-composer-help-button
Granted, it isn’t right aligned, but it gives people a way to add customize help for the format bar should they deem that a necessity.
7 « J'aime »
Also, this was written before the new outlet (that Canned Replies uses) to display help text at. So it could be improved to use that same location instead of a modal now (if someone has the time PR welcome).
Right-aligning the button might require a new outlet or a new option to the toolbar component (PR welcome for that too).
But those would be the only necessary improvements to make it meet the UI mock ups above.
3 « J'aime »
None of that is new; I worked with Ben to add that in 2010/2011. See proof here…
4 « J'aime »
Yeah it fealt eerily familiar. I guess I think there is merit for a help mode that kicks out once you posted a bit
But sure this can be plugin territory, agree that for seasoned users a help button is largely noise
2 « J'aime »
For what it’s worth, I appreciate the comfort of being able to find some kind of formatting help, even if it’s rarely used.
It’s good for bootstrapping new users unfamiliar with markdown (like communities coming from more bb related forms, or with wysiwyg editors), and a nice reminder for when I just can’t figure out how how to do something simple like code formatting, and have been deep in JIRA or Sharepoint or something with vastly different formatting options.
7 « J'aime »
Publication croisée d’une demande plus récente pour un sujet similaire - Hard to find the Markdown help button
3 « J'aime »
Mon avis à ce sujet :
Les personnes inexpérimentées ne savent pas vraiment comment utiliser les fonctionnalités markdown.
Une aide sur le markdown faciliterait l’apprentissage du markdown pour les utilisateurs novices. D’autres utilisateurs ont publié des messages d’aide sur le markdown. Je pense que cette fonctionnalité serait utile, car elle améliorerait la facilité d’accès.
Alternativement, nous pourrions également ajouter plus de boutons markdown en haut pour les novices. Cependant, le problème est que cela rend la mise en page plus confuse.
2 « J'aime »
Je pense que ce serait une excellente idée d’ajouter également cette section (barre d’outils) à New User Tips, comme Jeff l’a mentionné ci-dessus. 
Avec une petite description et un lien configurable à l’intérieur. Il peut s’agir d’un sujet dédié à la mise en forme comme Understanding Discourse for new users
Ou il peut aller directement à l’aide Markdown Markdown Reference
4 « J'aime »
Les utilisateurs voient :
Tapez ici. Utilisez Markdown, BBCode ou HTML pour formater.
OK, ils utilisent Markdown, BBCode ou HTML, mais constatent que certaines choses ne fonctionnent pas,
et il y a d’autres choses que d’autres utilisateurs utilisent qui fonctionnent mais dont ils ignoraient l’existence.
Il existe donc différentes versions de Markdown, BBCode ou HTML.
Ainsi, dans l’aide, Discourse devrait indiquer quelles versions.
Ou à la place de cela, simplement avoir la liste complète des éléments de balisage que
Discourse utilise.
Ou au moins avoir un lien vers le code source où il se trouve.
Mais les utilisateurs normaux ne pourraient pas comprendre ce code source,
Il serait donc toujours préférable d’avoir une liste complète, ou un aide-mémoire,
des opérateurs de balisage implémentés par Discourse.
2 « J'aime »
Alors où la syntaxe [details=summary][/details] est-elle documentée ?
- Elle n’est mentionnée sur aucune des pages référencées ci-dessus car il s’agit d’une fonctionnalité personnalisée de Discourse.
- Une recherche de « [details] » sur meta montre qu’elle existe et qu’elle pourrait être décrite comme « masquer », mais ne donne aucun indice sur le fonctionnement de la syntaxe de résumé.
- Une recherche sur le web montre le dépôt discourse-details, mais celui-ci ne contient plus d’informations sauf « Plugin déprécié, désormais intégré par défaut à Discourse ».
- Je l’ai finalement trouvée dans Details in topic styling changes - Feedback. Pas là où je m’attendrais à envoyer les utilisateurs pour en apprendre la syntaxe.
J’aurais vraiment aimé un bouton d’aide renvoyant à une sorte de documentation officielle…
Cela fait partie du tutoriel discobot
1 « J'aime »
Si vous cliquez sur l’engrenage, il vous proposera de l’insérer pour vous
Donc, les personnes qui ne cliqueront pas sur l’engrenage ne cliqueront probablement pas non plus sur une icône d’aide. 
1 « J'aime »
Il existe un tutoriel Discobot ? J’utilise et je promeus Discourse depuis de nombreuses années et je n’ai jamais rencontré cela, ni l’idée que c’est là qu’il faut aller pour apprendre à utiliser Discourse. Même maintenant, je n’ai aucune idée (en regardant notre instance Discourse) comment je pourrais faire cela.
Je pensais que je ratais quelque chose, ou peut-être que le discobot a été introduit après que j’ai commencé à utiliser Discourse, alors je suis allé sur Understanding Discourse for new users. Aucune mention du tutoriel discobot, ni de [details]. Il y a Markdown Tutorial - Introduction listé, mais seulement pour common mark.
@pfaffman Je vois maintenant cette option sous l’engrenage. Ce n’est pas que je ne cliquerais pas sur l’engrenage, mais que je pensais savoir ce que l’engrenage signifiait - changer les paramètres. (J’avais tort.) Cela, combiné à l’hypothèse qu’il y a probablement un tas de fonctionnalités spécifiques à Discourse comme [details], m’a convaincu qu’elles ne seraient pas toutes listées dans un menu caché, j’ai donc commencé à chercher un manuel.
J’aurais certainement cliqué sur un bouton d’aide si l’un des boutons était clairement destiné à l’aide (c’est-à-dire un point d’interrogation). J’aurais également cliqué sur un bouton s’il était clairement destiné à insérer des choses. Je m’étais juste inconsciemment convaincu que ce ne pouvait pas être l’engrenage…
Peut-être suis-je à l’ancienne, mais je veux vraiment une source faisant autorité où je peux apprendre toutes les fonctionnalités et y faire référence à l’avenir. Existe-t-il une telle chose, ou l’apprentissage par les bots est-il la nouveauté ?
1 « J'aime »
Créez un nouveau compte sur un site Discourse.
Pas autre chose que de suivre les annonces ici. Un effort accru a été fait pour documenter les choses ici dans la documentation Documentation - Discourse Meta, mais je ne sais pas si cela semble faire autorité.
Merci. Donc, si je crée un nouveau compte, je vois effectivement le discobot. Cependant, il est très déroutant de savoir comment interagir avec lui pour un utilisateur comme moi qui a rejoint avant que le discobot ne soit lancé. C’est peut-être un peu hors sujet, mais cela souligne un besoin potentiel d’un bouton d’aide, alors je vais garder la discussion ici. N’hésitez pas à déplacer ou à me diriger vers un meilleur sujet si vous pensez que c’est approprié.
Ayant récemment découvert le discobot, j’ai essayé de l’utiliser sur nos sites. Conformément à diverses discussions et mentions, je m’attendais à pouvoir taper quelque part @discobot start tutorial et apprendre…
- J’ai essayé cela dans le chat du site sur un site. Rien ne s’est passé. J’ai essayé d’initialiser un chat personnel avec @discobot, mais il n’a pas pu être trouvé.
- J’ai ensuite essayé d’envoyer un “Chat personnel” au discobot. Je n’ai pas pu.
- Sur l’un de nos sites, j’ai pu ajouter discobot à ma liste de chats personnels, mais lui demander de “démarrer le tutoriel” n’a rien fait.
- Enfin, j’ai créé un nouveau compte sur ce site, et j’ai été accueilli par le bot, ce qui a clairement indiqué qu’il devrait y avoir un Sujet avec mes interactions avec le bot (et que je devrais marquer ce sujet).
Maintenant, je vois que je peux rechercher discobot sur notre site, aller sur sa page utilisateur, puis lui envoyer un message, où je dois confusément entrer un long titre et un contenu. Enfin, après la création de ce message, je peux lui demander de “démarrer le tutoriel”.
Pourquoi est-ce si difficile ? Pourquoi le bot ne répond-il pas aux demandes de démarrage du tutoriel dans les chats, les chats privés, etc. ? Qu’en est-il de quelqu’un qui commence sur un site, passe outre les paramètres de notification et ne remarque pas le discobot ? Comment obtiennent-ils de l’aide plus tard ?
Je ne sais pas quelle est la meilleure solution, mais un bouton d’aide quelque part qui m’aurait guidé à travers cela aurait été très utile.
1 « J'aime »
Avez-vous désactivé Discobot dans vos paramètres ? Utilisez-vous une version très ancienne de Discourse ?
1 « J'aime »