Docs im Forum sichtbarer machen?

Ich bin seit Jahren Mitglied dieses Forums, aber ich benutze Documentation - Discourse Meta nie, weil ich vergesse, dass es existiert.

Ich dachte sogar einmal: „Es wäre cool, wenn es einen Docs-Link in der oberen Navigation gäbe…“ und dann wurde mir klar, dass es bereits einen gibt:

image

Aus irgendeinem Grund hat mein Gehirn ihn komplett ignoriert.

Außerdem ist der Link in der Seitenleiste am Ende des Menüs „Mehr“ versteckt, von dem ich glaube (keine Daten zur Unterstützung dieses Gedankens), dass es nur sehr wenige Leute anklicken.

Ich habe mich auch gefragt, ob ein Symbol neben dem Docs-Navigationsbutton meinem Gehirn helfen würde, es zu bemerken.

image

Und was ist mit der Platzierung neben dem Logo im Header? Vielleicht zwei Links? Einer für Documentation - Discourse Meta, einer für https://docs.discourse.org/?

Außerdem stört mich etwas:

  • Docs ist Meta-Dokumentation

  • Discourse Docs ist das Plugin.

  • #docs ist der Tag, der sich auf das Plugin bezieht.

  • Die Links image & image führen zu Docs

  • #documentation ist eine Kategorie, die nicht direkt mit Docs zusammenhängt.

  • docs.discourse.org ist die API-Dokumentation.

Ein bisschen verwirrend, oder?

Das Hauptproblem ist jedoch, dass ich immer vergessen habe, dass Documentation - Discourse Meta existiert, und deshalb benutze ich es nie. Das Nächstbeste, was ich tue, ist die Suche zu benutzen, beginnend mit #documentation.

7 „Gefällt mir“

Als zusätzlichen Bonus können Sie auch den Filter in:docs bei Ihrer Suche verwenden. :+1:

4 „Gefällt mir“

Ich auch!

Ich ging davon aus, dass das ein Witz sei. Ich beklagte mich kürzlich, dass es KEINE MÖGLICHKEIT GIBT, DIE DOKUMENTE ZU FINDEN. Aber das ist kein Witz. Es ist genau da. Ganz offensichtlich.

Das scheint auch zuzutreffen, außer dass ich neulich danach gesucht habe und dachte, ich könnte es dort nicht finden, oder vielleicht dachte ich einfach, es müsse nicht so versteckt sein.

Ich bin mir nicht sicher, ob dies ein Fall von UX oder von „man kann ein Pferd zum Wasser führen“ ist.

1 „Gefällt mir“

Ich denke, ein kleiner Teil des Problems, auf den @chapoi irgendwann in der Vergangenheit hingewiesen hat, ist, dass dieses Menü eigentlich kein Navigationsmenü sein soll… es ist ein Filtermenü, zu dem wir ein paar Navigationslinks hinzugefügt haben (Kategorien und Docs).

Screenshot 2023-05-16 at 12.30.08 PM

Es wäre sinnvoller, wenn Docs im Abschnitt „Community“ der Seitenleiste neben anderen Navigationslinks (nicht in der Schublade) angesiedelt wären. Dies könnte die Auffindbarkeit verringern, wenn jemand die Seitenleiste nicht verwendet, aber wenn der Link zu den Docs offensichtlicher sein muss, müssen wir ihn vielleicht auch woanders hervorheben :thinking:

5 „Gefällt mir“

Praktisch keiner meiner normalen mobilen Benutzer benutzt die Seitenleiste. Es gibt nichts, was sie brauchen. Und… eigentlich verstehe ich sie.

3 „Gefällt mir“

Ich denke, das ist ein Fall für „Ja, und…“

Wir haben die Dokumentation tatsächlich an drei Stellen verlinkt:

  • Banner für neue, anonyme Benutzer
  • Filterüberschrift oben
  • Seitenleiste

Mein Vorschlag wäre, die Dokumentation in der Seitenleiste „above the fold“ (im sichtbaren Bereich) zu platzieren, sodass sie unter „Topics“ angezeigt wird. Außerdem sollte sie ein Buch-Symbol :open_book: erhalten.

Außerdem sollte ein Verweis darauf in New to Discourse? Start here! hinzugefügt werden, das angeheftet ist und das wir erwarten, dass die Leute es lesen, wenn sie Meta beitreten.

1 „Gefällt mir“

Ich habe gerade „Docs“ zum ersten Teil des Menüs unter „Topics“ hinzugefügt, um zu sehen, wie es aussehen würde. Es gefällt mir!

Allerdings sehe ich nicht, wie ich den anderen Link entfernen kann, der automatisch am Ende dieser Liste hinzugefügt wird. Wahrscheinlich wäre eine Änderung im Plugin erforderlich, um zu verhindern, dass er automatisch angezeigt wird, oder um ihn konfigurierbar zu machen.

3 „Gefällt mir“

Entschuldigung für den dreifachen Beitrag. Ich habe ihn erneut aus der Seitenleiste entfernt, um die doppelte Auflistung von Dokumenten zu verhindern. Wir arbeiten an einer Lösung, um die Anpassung von Seitenleistenelementen für Plugins zu ermöglichen, was uns hier helfen wird.

1 „Gefällt mir“