A help button could be useful either way
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.
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
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.
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.
None of that is new; I worked with Ben to add that in 2010/2011. See proof here…
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
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.
Erneutes Posten einer neueren Anfrage für ähnliches - Hard to find the Markdown help button
Meine Meinung dazu:
Unerfahrene Leute wissen nicht wirklich, wie sie die Markdown-Funktionen nutzen können.
Eine Markdown-Hilfe würde es neuen Benutzern erleichtern, Markdown zu lernen. Andere Benutzer haben Dinge zur Markdown-Hilfe gepostet. Ich glaube, es wäre nützlich, diese Funktion zu haben, da sie die Zugänglichkeit erleichtern würde.
Alternativ könnten wir auch mehr Markdown-Schaltflächen oben für Neulinge hinzufügen. Das Problem dabei ist jedoch, dass dies das Layout verwirrender macht.
Ich denke, es wäre eine großartige Idee, diesen Abschnitt (Symbolleiste) auch zu New User Tips hinzuzufügen, wie Jeff oben erwähnt. ![]()
Mit einer kleinen Beschreibung und einem konfigurierbaren Link darin. Es kann zu einem eigenen Thema über Formatierung gehen, wie Understanding Discourse for new users
Oder es kann direkt zur Markdown-Hilfe Markdown Reference gehen.
Benutzer sehen:
Hier tippen. Verwenden Sie Markdown, BBCode oder HTML zur Formatierung.
OK, sie verwenden Markdown, BBCode oder HTML, stellen aber fest, dass einige Dinge nicht funktionieren und es andere Dinge gibt, die andere Benutzer verwenden, die funktionieren, aber sie nicht kannten.
Es gibt also verschiedene Versionen von Markdown, BBCode oder HTML.
In der Hilfe sollte Discourse also sagen, welche Versionen.
Oder stattdessen einfach die vollständige Liste der Markup-Elemente anzeigen, die Discourse verwendet.
Oder zumindest einen Link zum Quellcode haben.
Aber normale Benutzer könnten diesen Quellcode nicht verstehen.
Daher wäre es immer noch besser, eine vollständige Liste zu haben oder sie als Spickzettel zu bezeichnen, der von Discourse implementierte Markup-Operatoren.
Wo ist die [details=summary][/details]-Syntax dokumentiert?
- Sie wird auf keiner der oben genannten Seiten erwähnt, da es sich um eine benutzerdefinierte Discourse-Funktion handelt.
- Eine Suche nach „[details]“ auf Meta zeigt dass sie existiert und dass sie als „verstecken“ beschrieben werden könnte, gibt aber keinen Hinweis darauf, wie die Zusammenfassungssyntax funktioniert.
- Eine Suche im Web zeigt das discourse-details Repository, aber dieses enthält jetzt keine Informationen mehr außer „Plugin veraltet, jetzt standardmäßig Teil von Discourse“.
- Ich habe es schließlich in Details in topic styling changes - Feedback gefunden. Nicht dort, wo ich erwarten würde, dass Benutzer hingeschickt werden, um etwas über die Syntax zu erfahren.
Ich hätte mir wirklich einen Hilfe-Button gewünscht, der auf eine Art offizielle Dokumentation verweist…
Es ist Teil des Discobot-Tutorials
Wenn Sie auf das Zahnrad klicken, wird angeboten, es für Sie einzufügen
Leute, die nicht auf das Zahnrad klicken, werden wahrscheinlich auch nicht auf ein Hilfe-Symbol klicken. ![]()
Gibt es ein Discobot-Tutorial? Ich benutze und empfehle Discourse seit vielen Jahren und bin noch nie auf dieses gestoßen oder auf die Idee, dass man dort etwas über die Verwendung von Discourse lernen sollte. Selbst jetzt habe ich (wenn ich mir unsere Discourse-Instanz ansehe) keine Ahnung, wie ich das machen würde.
Ich dachte, ich hätte etwas verpasst, oder vielleicht wurde der Discobot eingeführt, nachdem ich mit der Verwendung von Discourse begonnen hatte, also ging ich zu Understanding Discourse for new users. Keine Erwähnung des Discobot-Tutorials oder von [details]. Es gibt Markdown Tutorial - Introduction, aber nur für Common Mark.
@pfaffman Ich sehe jetzt diese Option unter dem Zahnrad. Es ist nicht so, dass ich nicht auf das Zahnrad klicken würde, sondern dass ich dachte, ich wüsste, was das Zahnrad bedeutet – Einstellungen ändern. (Ich lag falsch.) Das, kombiniert mit der Annahme, dass es wahrscheinlich eine ganze Reihe von Discourse-spezifischen Funktionen wie [details] gibt, überzeugte mich, dass sie nicht alle unter einem versteckten Menü aufgeführt würden, also begann ich nach einem Handbuch zu suchen.
Ich hätte sicherlich auf eine Hilfe-Schaltfläche geklickt, wenn eine der Schaltflächen offensichtlich für Hilfe gedacht wäre (d. h. ein Fragezeichen). Ich hätte auch auf eine Schaltfläche geklickt, wenn sie offensichtlich zum Einfügen von Dingen gedacht wäre. Ich hatte mich einfach unterbewusst davon überzeugt, dass es nicht das Zahnrad sein konnte…
Vielleicht bin ich altmodisch, aber ich möchte wirklich eine maßgebliche Quelle zum Lesen haben, in der ich etwas über alle Funktionen lernen und zukünftig darauf verweisen kann. Gibt es so etwas, oder ist das Lernen über Bots das Neue?
Erstellen Sie ein neues Konto auf einer Discourse-Website.
Nicht anders als die Ankündigungen hier zu verfolgen. Es wurden verstärkte Anstrengungen unternommen, um die Dokumentation hier in den Docs Documentation - Discourse Meta zu verbessern, aber ich weiß nicht, ob sie sich maßgeblich anfühlt.
Danke. Wenn ich also ein neues Konto erstelle, sehe ich tatsächlich den Discobot. Es ist jedoch sehr verwirrend, wie man mit ihm interagiert, für einen Benutzer wie mich, der beigetreten ist, bevor der Discobot gestartet wurde. Das ist vielleicht etwas vom Thema ab, hebt aber einen potenziellen Bedarf an einer Hilfe-Schaltfläche hervor, daher werde ich die Diskussion hier fortsetzen. Fühlen Sie sich frei, mich zu verschieben oder an ein besseres Thema zu verweisen, wenn Sie es für angemessen halten.
Nachdem ich den Discobot neu entdeckt hatte, versuchte ich, ihn auf unseren Websites zu verwenden. Gemäß verschiedenen Diskussionen und Erwähnungen erwartete ich, dass ich irgendwo @discobot start tutorial eingeben könnte und lernen würde…
- Ich habe dies im Site-Chat auf einer Website versucht. Nichts geschah. Ich habe versucht, einen persönlichen Chat mit
@discobotzu initiieren, aber er konnte nicht gefunden werden. - Ich habe dann versucht, dem Discobot eine “persönliche Nachricht” zu senden. Das konnte ich nicht.
- Auf einer unserer Websites konnte ich den Discobot zu meiner Liste persönlicher Nachrichten hinzufügen, aber ihn aufzufordern, “start tutorial” zu sagen, tat nichts.
- Schließlich habe ich auf dieser Website ein neues Konto erstellt und wurde vom Bot begrüßt, was klar machte, dass es ein Thema mit meinen Interaktionen mit dem Bot geben sollte (und dass ich dieses Thema als Lesezeichen speichern sollte).
Jetzt sehe ich, dass ich auf unserer Website nach discobot suchen, zu seiner Benutzerseite gehen und ihm dann eine Nachricht senden kann, wo ich verwirrenderweise einen langen Titel und etwas Inhalt eingeben muss. Schließlich, nachdem diese Nachricht erstellt wurde, kann ich ihn auffordern, “start tutorial” zu sagen.
Warum ist das so schwer? Warum reagiert der Bot nicht auf Anfragen, den Tutorial in Chats oder privaten Chats usw. zu starten? Was ist, wenn jemand, der auf einer Website anfängt, die Benachrichtigungseinstellungen überspringt und den Discobot nicht bemerkt? Wie bekommen sie später Hilfe?
Ich weiß nicht, was die beste Lösung ist, aber eine Hilfe-Schaltfläche irgendwo, die mich durch diesen Prozess geführt hätte, wäre sehr hilfreich gewesen.
Hast du Discobot in deinen Einstellungen deaktiviert? Läuft bei dir ein sehr altes Discourse?



