Neue Haushalte für offizielle und Gemeinschaftsdokumentation

Ich freue mich, einige Updates zur Art und Weise, wie wir mit Dokumentation umgehen, bekannt zu geben, um Klarheit und Zusammenarbeit zu gewährleisten und gleichzeitig die Qualität der bereitgestellten Informationen aufrechtzuerhalten. Lesen Sie weiter, um zu verstehen, wie unser neues Dokumentations-Setup funktioniert.

:writing_hand: Offizielle Dokumentation

Wir haben die Kategorie Documentation aktualisiert, damit sie ausschließlich offiziellen Dokumentationen vorbehalten ist. Das bedeutet, dass alle Inhalte in ihren Unterkategorien von Mitgliedern des Discourse-Teams gepflegt werden, um sicherzustellen, dass die Informationen korrekt und aktuell sind. Wenn Sie nach den maßgeblichsten Leitfäden und Referenzen suchen, sind Sie hier richtig!

Warum nur Teammitglieder?

Die Beschränkung der Erstellung und Bearbeitung offizieller Dokumentationen auf unser Team sorgt für Konsistenz und Zuverlässigkeit. Unser Ziel ist es, präzise, gut gepflegte Ressourcen für alle bereitzustellen – von neuen Benutzern bis hin zu erfahrenen Entwicklern. Alle Community-Mitglieder können nach wie vor auf diese Themen antworten, um den Inhalt zu diskutieren oder Änderungen vorzuschlagen.

:people_hugging: Community-Wiki

Keine Sorge, es gibt auch viel Platz für Ihre Beiträge! Alle von der Community beigetragenen Dokumentationen finden Sie nun in der Kategorie Wiki. Hier kommen die Expertise, Tipps und das kollektive Wissen unserer lebendigen Community zusammen.

Wer kann beitragen?

Benutzer mit einem Vertrauenslevel von 2 und höher haben die Befugnis, Themen in Wiki zu erstellen und zu bearbeiten. Dies ermöglicht es erfahrenen Benutzern, ihr Wissen zu teilen und die Vielfalt und den Reichtum unserer Community-Ressourcen zu bereichern. Das bedeutet auch, dass vertrauenswürdige Community-Mitglieder jede von der Community erstellte Dokumentation bearbeiten können, die sie als falsch oder veraltet vorfinden.

:question: Warum diese Änderung?

Diese Richtlinie soll das Bedürfnis nach offizieller, gepflegter Dokumentation und den wertvollen Beiträgen unserer Community in Einklang bringen. Sie bietet zudem eine klare Struktur für Benutzer, die Informationen suchen – unabhängig davon, ob sie offizielle Anleitungen oder Ratschläge der Community benötigen.

Wir schätzen die Beiträge aller von Ihnen und sind überzeugt, dass die Umstellung auf einen dedizierten Raum für Ihre Dokumentationsbeiträge dazu beitragen wird, dass diese gedeihen und die Aufmerksamkeit erhalten, die sie verdienen.

:derek_pointing: Wir brauchen Sie!

Das Community-Wiki hat bereits einen Vorsprung bei der Entwicklung zu einem robusten, von der Community getragenen Raum für Lernen und Wissensaustausch, und wir würden uns über weitere Beiträge von Ihnen freuen. Wenn Sie großartige Tutorials, Konfigurationen oder Ratschläge haben, wartet Wiki auf Ihre Beiträge!


Sie können diese Dokumentationsrichtlinie an ihrem dauerhaften Standort hier finden:

10 „Gefällt mir“

Darf ich erfahren, was mit dem Scribe-Abzeichen geschieht?

4 „Gefällt mir“

Gibt es eine einfache Möglichkeit, beide Dokumentationsquellen gleichzeitig zu durchsuchen? Mir ist bewusst, dass ich über mehrere Kategorien hinweg suchen kann, aber das ist umständlicher, als einfach mit Hilfe von Autovervollständigung ‘Documentation’ hinzuzufügen.

Ich glaube, ich kann stattdessen in:docs verwenden, da beide Kategorien hinzugefügt werden? in:kb, was auch für Discourse Docs funktionierte, scheint nicht zu funktionieren.

Und wie funktioniert das für Unterkategorien? Wie suche ich zum Beispiel nach allen Informationen, die für Benutzer geschrieben wurden. Kann ich gleichzeitig in Community wiki > Users und Documentation > Using Discourse suchen?

5 „Gefällt mir“

Ein klassisches Tag-Beispiel. Aber… dann gäbe es so viele Tags, dass es fast unmöglich ist, sie zu verwalten.

3 „Gefällt mir“

Der Scribe-Badge wurde aktualisiert, um Beiträge zum Community-Wiki abzudecken :slight_smile:

3 „Gefällt mir“

Ja – du kannst in:docs verwenden, und es werden Themen sowohl in Documentation als auch in Wiki durchsucht.

Die Suche schließt auch Themen in den Unterkategorien ein, diese sind also bereits Teil der Ergebnisse.

Dafür müsstest du categories:users,using-discourse in der Suche angeben.

2 „Gefällt mir“

Aber all diese erfordern ziemlich tiefgreifende Discourse-Kenntnisse, da keine davon in der (erweiterten) Suchoberfläche unterstützt wird.
Sollte die Dokumentation nicht so einfach wie möglich durchsuchbar sein?

5 „Gefällt mir“

Ich denke, das unterstreicht eher Dinge, die wir in der Discourse-Benutzeroberfläche verbessern können. Insbesondere die Möglichkeit, mehrere Kategorien in der erweiterten Suche auszuwählen, unter anderem.

Dies bietet eine großartige Gelegenheit und zusätzliche Motivation, an solchen Updates zu arbeiten, daher werden wir sehen, was wir dort tun können! Wir werden dies besprechen und ich werde hier mit allen Updates zurückkommen.

4 „Gefällt mir“