Möglichkeiten zur Mitwirkung an der Dokumentation

Die Discourse-Dokumentation ist die erste Anlaufstelle für Administratoren, Moderatoren, Benutzer und Systemadministratoren, um Hilfe bei der Nutzung von Discourse und beim Management ihrer Foren zu finden.

Obwohl diese Dokumentation umfangreich ist und viele Bereiche abdeckt, gibt es einige Lücken, die noch nicht dokumentiert sind. Dies ist eine großartige Gelegenheit für die Community, sich zu engagieren und an der Verbesserung dieses wichtigen Teils des Discourse-Projekts mitzuwirken.

Wir würden uns freuen, wenn sich mehr Menschen an der Erstellung von Dokumentationsinhalten für Discourse beteiligen, und möchten es jedem so einfach wie möglich machen, dies zu tun. Zu diesem Zweck finden Sie unten eine Liste von Discourse-Funktionen oder Anwendungsfällen, für die wir neuen oder verbesserten Dokumentationsbedarf identifiziert haben.

:notebook_with_decorative_cover: Dokumentationsstandorte

Jeder mit Vertrauensstufe 2 oder höher kann neue Dokumentationsthemen im Bereich Wiki erstellen – dies ist die Heimat aller von der Community beigetragenen Dokumentationsinhalte. Wenn ein Thema im Community-Wiki als relevant oder wichtig erachtet wird, kann es in den Bereich Documentation verschoben werden – die Heimat aller offiziellen Discourse-Dokumentationen. Weitere Details dazu finden Sie in der Dokumentationsrichtlinie.

:gift: Abzeichen für Dokumentationsbeiträge

Jeder, der ein neues Thema in der Kategorie Wiki erstellt, erhält automatisch das Bronze-Abzeichen Scribe:

Wenn das Thema als ausreichend wertvoll erachtet wird, um in die offizielle Kategorie Documentation verschoben zu werden, übernimmt dies ein Mitglied des Discourse-Teams manuell, vermerkt den ursprünglichen Autor im Themeninhalt und vergibt das Silber-Abzeichen Ghostwriter:

:eyes: Zu schreibende Dokumentation

Obwohl wir letztlich wünschen, dass jeder Teil von Discourse gründlich dokumentiert wird, sind dies die Bereiche, in denen wir den dringendsten Bedarf identifiziert haben (durchgestrichene Elemente zeigen Themen an, die seit der ersten Veröffentlichung dieses Beitrags erstellt wurden):

  • Ein allgemeiner Einstiegstutorial für Administratoren
  • Benutzerdefinierte Topic-Weiterleitungen
  • Erklärung, was verschiedene Benutzerstufen tun können
  • Optionen für Social Logins
  • Post-Hinweise (offizielles Dokument)
  • Weitere Dokumentation darüber, wie Vertrauensstufen funktionieren
  • [x ] So schreiben Sie eine gute Feature-Anfrage für Discourse (Wiki-Thema)
  • Eine Referenz dazu, wie Discourse-Markdown- und Formatierungsfunktionen in E-Mails aussehen
  • Benutzerstatus (Wiki-Thema)
  • Erklärung des Dunkelmodus, wie man ihn auswählt und wie man das Umschalten aktiviert (Wiki-Thema)
  • Allgemeine Dokumentation zur Verwaltung von Benutzereinstellungen (Wiki-Thema)
  • Dokumente, die erklären, wie Kategorien und Hierarchien in Discourse funktionieren
  • Ein allgemeiner Leitfaden für Topic-Einstellungen
  • Ein allgemeiner Leitfaden zu Plugins – was sie sind, wie sie funktionieren und wie man sie verwendet
  • Benutzerdefinierte Startseiten
  • Ändern von Standardkategorien und -topics
  • Verwendung von Bildraster in Beiträgen (Wiki-Thema)
  • Einstellungen zur Post-Billigung (Wiki-Thema)

Einige dieser Punkte erfordern möglicherweise mehrere Themen, um effektiv dokumentiert zu werden.

:pencil2: So schreiben Sie Dokumentation

Um sicherzustellen, dass die Discourse-Dokumentation so effektiv wie möglich ist, haben wir einen Styleguide dafür, wie man diese Inhalte schreibt. Obwohl es hilfreich wäre, wenn alle den Leitfaden befolgen, ist es kein Problem, wenn Sie beim Beitrag zu Wiki nicht vollständig daran festhalten. Alle Themen, die in den Bereich Documentation verschoben werden, werden vom Discourse-Team nach Bedarf aktualisiert, um dem Styleguide zu entsprechen.

:bulb: Interessiert?

Tauchen Sie ein in Wiki und beginnen Sie noch heute mit der Dokumentation. Wenn Sie diesbezüglich diskutieren möchten, können Sie gerne auf dieses Thema antworten, um darüber zu sprechen.

12 „Gefällt mir“

Was ist mit den bestehenden Themen? Zum Beispiel

4 „Gefällt mir“

Für diese hier:

Die bestehende Dokumentation spricht darüber, wie man neue Funktionen anfordert, aber nicht darüber, wie man eine gute Anfrage formatiert, um sie effektiver zu gestalten. Wir verlinken derzeit auf diese Seite, aber es wäre gut, wenn wir diese Art von Inhalten stattdessen auf Meta hätten.

Und für diese hier:

Guter Fang! Ich werde das aus der Liste in diesem Thema entfernen :slight_smile:

3 „Gefällt mir“

Es gibt bereits dieses Thema, das Funktionsanfragen behandelt

Es sei denn, es soll so aussehen, aber für eine Funktionsanfrage? :point_down: :eyes:

4 „Gefällt mir“

Bedeutet das „Mitarbeiterhinweis“ oder etwas anderes?

1 „Gefällt mir“

Ich gehe davon aus, dass dies eine Beitragsmitteilung ist, da sie im Titel steht

Mitarbeitermitteilungen sind im Grunde dasselbe, nehme ich an?

3 „Gefällt mir“

Ja, das ist es, was wir dort suchen :slight_smile:

Wie @ondrej verlinkt hat, sind Post Notices das, was in dieser Ankündigung beschrieben wird. Wir haben dieses Ankündigungsthema, aber keine tatsächliche Dokumentation dazu.

4 „Gefällt mir“

Hallo Hugh, das ist eine tolle Idee.

Ich wollte schon seit Längerem eine Idee für das Community-Wiki vorstellen, um eine Art Tag für Forum-Vorlagen zu haben.

Die Idee, die ich dafür habe. Oft fragen Leute, wie sie Discourse für Dinge wie ein Support-Forum, eine Lernplattform usw. nutzen können. Manchmal sogar für obskurere Zwecke wie ein Tabletop-Rollenspiel.

Wenn wir Inhalte aus solchen Themen sammeln und uns verschiedene Anwendungsfälle überlegen. Könnten wir eine neue Ressource mit einem Hauptthema erstellen, das als Index dient.

  • Vorlagen für Support-Foren
  • Vorlagen für Lernplattformen

Diese Themen können gehostet werden von Discourse, Communique (so?) usw. mit empfohlenen Plugins und Theme-Komponenten usw. sowie einem Beitrag für Self-Hosted.

Gehostete Vorlagen würden sich auf die Plugins konzentrieren und angeben, welche Pläne für die Verwendung eines bestimmten Plugins benötigt werden.

Mit Tipps und Tricks und sogar Verweisen auf den Marketplace, wenn sie ein benutzerdefiniertes Layout, ein Plugin usw. benötigen.

3 „Gefällt mir“

Erstellt:

7 „Gefällt mir“

Das habe ich gesehen :smile: Toll zu sehen, dass diese eintreffen!

8 „Gefällt mir“

Arbeite an der für den Dunkelmodus.

5 „Gefällt mir“

Diese Anleitungen wurden bereits erstellt, aber noch nicht abgehakt:

Diese hier ist etwas unklar. Bezieht sie sich auf benutzerdefinierte Startseiteninhalte? Wenn ja, dann vielleicht Add custom content that only appears on your homepage. Andernfalls… wurde sie noch nicht geschrieben.

2 „Gefällt mir“

Danke, dass Sie sich hier noch einmal gemeldet haben – ich habe die OP mit diesen Links aktualisiert.

Dies ist eine ziemlich spezielle Sache und bezieht sich auf die Erstellung einer benutzerdefinierten Homepage, also nichts, was die meisten Discourse-Administratoren verwenden werden. Es ist keine Hauptfunktion, da sie in diesem Stadium noch nicht vollständig ausgereift ist.

2 „Gefällt mir“