Link zur CommonMark-Dokumentation im Editor bereitstellen

Ich denke, es wäre hilfreich, einen Link zur CommonMark-Referenz oder alternativ zu einem benutzerdefinierten Thema bereitzustellen, um Menschen beim Bearbeiten von Inhalten zu unterstützen, die nicht über die Symbolleisten-Schaltflächen möglich sind. Wenn ein Link zu einem benutzerdefinierten Thema konfiguriert werden kann, könnten auch plattformspezifische Formatierungen wie die des Checkmark-Plugins dokumentiert werden.

Eine Fragezeichen-Schaltfläche ganz rechts in der Symbolleiste scheint eine gute Möglichkeit zu sein, diesen Link hinzuzufügen.

7 „Gefällt mir“

Ich kann nicht sagen, ob dies langfristig in den Kern übernommen wird, aber es scheint ein idealer Kandidat für eine Theme-Komponente zu sein, um damit zu beginnen.

11 „Gefällt mir“

Sehr schnelle Umsetzung: Passe die Texte für den Schlüssel education.* auf der Website an, die auf das benutzerdefinierte Thema für deine Seite verweisen. :sunglasses:

6 „Gefällt mir“

Diese Meldungen werden doch nur beim ersten Mal angezeigt, wenn du ein neues Thema/eine neue Antwort verfasst, oder?

2 „Gefällt mir“

Ja, aber das macht sie auch zu einem viel geeigneteren Ort für diese Informationen :information_source:

4 „Gefällt mir“

Ich bin anderer Meinung. Dies wäre ein Link zu einer Referenz, die man konsultieren kann, wenn man sich an eine selten verwendete Markdown-Syntax nicht erinnert. Es ist nicht etwas, das man einmal liest und dann nie wieder braucht.

1 „Gefällt mir“

Du scheinst der Illusion zu erliegen, dass Nutzer alles lesen werden, was du auf dem Bildschirm anzeigst.

Das werden sie nicht.

Die besten Ansätze bestehen darin, dem Nutzer die Informationen genau dann bereitzustellen, wenn er sie am dringendsten braucht – und nicht eine Ansammlung willkürlicher Permalinks auf dem Bildschirm abzulegen „für den Fall der Fälle“, die in 99,999 % der Fälle ignoriert werden und für alle Nutzer zusätzlichen Ballast darstellen.

3 „Gefällt mir“

Nein, tut mir leid, dich zu enttäuschen. :grin: Das ist einfach ein egoistischer Vorschlag für etwas, das ich persönlich praktisch finden würde. Er ist inspiriert vom GitHub-Editor, der einen Link zur GH-Markdown-Spezifikation enthält, die ich gelegentlich konsultiere.

Zustimmung, das wäre die ideale Lösung. Natürlich ist das leichter gesagt als getan. Das variiert stark zwischen einzelnen Nutzern, daher bin ich skeptisch hinsichtlich der Wirksamkeit eines solchen Ansatzes ohne umfangreiche Tests. Andernfalls basiert er nur auf Annahmen.

Ich nehme an, der Hinweis „Hast du die :heart-Taste gedrückt?“ ist ein Beispiel für diesen Ansatz? Aus irgendeinem Grund geht Discourse davon aus, dass ich dem Beitrag zustimme, auf den ich antworte, wenn meine Nachricht sehr wenige Zeichen enthält. Als ich das zum ersten Mal erlebt habe, war diese Annahme falsch und verursachte nichts als Verwirrung und Frustration.

Trotzdem glaube ich nicht, dass es eine einfache Lösung gibt, um Nutzer zu schulen. Bei Nutzern mit unterschiedlichem Hintergrund gibt es wahrscheinlich überhaupt keine Lösung, also nimm dies bitte nicht als Kritik.

2 „Gefällt mir“

Wenn du eine generische Markdown-Erinnerung suchst, schau dir commonmark.org an!

1 „Gefällt mir“

Noch eine Stimme für ein kleines :grey_question: ganz oben/unten rechts im Editor-Feld.

:ballot_box:

Dieses Plugin gibt es schon seit einiger Zeit

15 „Gefällt mir“

Die Art von Menschen, die dies praktisch finden würden, können sich selbst behandeln, indem sie proaktiv die Informationen suchen und finden, die sie benötigen. Sie sind bereits :star:-Studenten.

Außerdem … wenn Benutzer tatsächlich etwas lesen würden (was sie nicht tun), wären sie bereits zum Schritt zur Formatierung der interaktiven Willkommens-Nachricht des Discobots gelangt, die alle neuen Benutzer erhalten. Das ist am besten, da sie dynamisch und interaktiv ist, den eigentlichen Editor verwendet und Links zur Hilfe enthält.

Überprüfen Sie Ihre PMs, und Sie werden diese gleiche Willkommensnachricht auch dort sehen.

6 „Gefällt mir“

Danke. Ich habe angenommen, dass so etwas schon existieren muss, konnte es aber nicht finden.

Leider funktioniert es bei mir nicht. Der Fehler wurde hier gemeldet: Plugin not working with Discourse 2.5.0.beta1 · Issue #12 · cpradio/discourse-plugin-composer-help-button · GitHub

3 „Gefällt mir“

Viele Leute haben mich gefragt, wie man Markdown verwendet, daher finde ich diese Idee großartig. Es hat mich persönlich sehr lange gekostet, überhaupt herauszufinden, dass der Editor Markdown nutzt, und Anleitungen dazu zu finden.

Mein Vorschlag als Lösung dafür ist, neuen Benutzern oben im Editor einen blauen Kasten mit folgendem Text anzuzeigen:

“Erfahren Sie hier mehr darüber, wie Sie Ihren Text mit Markdown formatieren können: [link]”

Der blaue Kasten kann oben rechts ein Kreuz haben, damit Personen, die es nicht mehr sehen möchten, es dauerhaft schließen können.

3 „Gefällt mir“

Wie Jeff bereits sagte, vermittelt discobot einige Grundlagen von Markdown. Ist discobot auf deiner Instanz aktiviert?

3 „Gefällt mir“

Das tue ich. Ein Zufallstreffer: Jemand hat mich genervt und gedroht, Discourse nicht mehr zu nutzen, wenn ich nicht erklären könne, wie man es benutzt.

Am Ende habe ich diesen Artikel kopiert und im Forum global angepinnt. Dabei habe ich ein paar Dinge gelernt, die ich vorher nicht wusste.

2 „Gefällt mir“

Ein einfacherer Ansatz wäre vielleicht gewesen, auf

https://commonmark.org/help/

und

https://blog.discourse.org/2016/12/discourse-new-user-tips-and-tricks/

zu verlinken.

Beide Links werden in der Willkommens-PN für neue Nutzer gesendet, die jeder neue Nutzer erhält, nachdem er ein Konto in Discourse erstellt hat.

3 „Gefällt mir“