Wir haben eine ganze Reihe von Anleitungen. Manchmal teilen @dax oder @jomaxro eine #howto-Anleitung, von der ich nicht wusste, dass sie existiert, und ich bin beeindruckt!
Ich habe auch festgestellt, dass dies für viele neue Benutzer und Community-Manager auf Discourse hier auf Meta der Fall ist. Um dies zu lösen, hat @justin eine großartige Idee entwickelt, unsere How-Tos zu gruppieren und allen eine bessere Startbasis zu bieten, mit der Hoffnung, dass wir am Ende etwas Ähnliches wie https://support.teams.discourse.com/docs haben.
Haha, ja, gibt es! Idealerweise wären 6–12 Anleitungen pro Kategorie perfekt. Wir wollen nicht alle kategorisieren, sondern nur die besten, nach denen die Leute wahrscheinlich suchen.
@osioke – Ein Ansatz wäre, sich die am häufigsten angesehenen Anleitungen zu ansehen, die mit diesen Kategorien übereinstimmen, und die Top 6–12 davon als solche zu markieren. Das wäre ein einfacher Ausgangspunkt, kombiniert mit den Vorschlägen von @Benjamin_D hier!
Das Schöne an Tags ist, dass wir sie unterwegs ganz einfach bearbeiten können.
Danke, dass du das geteilt hast, @Benjamin_D! Eines der Dinge, bei denen ich Schwierigkeiten hatte, war, wie man die Struktur präsentiert und denkt. Deine Tabelle hier hilft sehr.
Ich möchte nun die Gruppierung von 3 auf 6 erweitern:
Erste Schritte
Einrichtung
Erweiterte Einrichtung
Mitwirken
Konfigurieren
Erweitertes Konfigurieren
Und wie @justin geteilt hat, schaue ich mir die meistgesehenen an. Hier sind die ersten 20:
Stimmt, die Liste basiert auf den 20 meistgesehenen Beiträgen, und ich habe sie geteilt, um meine Überlegungen zur Anordnung zu verdeutlichen. Sie ist keinesfalls die endgültige Liste – ich hätte etwas klarer sein sollen
Ich würde gerne „Administration“ oder „Betrieb“ als Kategorie für laufende Verwaltungs- und Moderationsaufgaben sehen. Das passt nicht zu Einrichtung/Konfiguration und ist auch keine Entwicklung/Dokumentation (Mitwirken).
Ich gehe davon aus, dass die Dokumentationsseite für Discourse for Teams Discourse selbst für alle Dokumente verwendet. Das Problem dabei für eine How-to-Website zu Discourse, an der jeder aus der Community teilnehmen kann, sind die Versionsverwaltung und die Nachverfolgung aller Änderungen. Ich bin sicher, dass die Nutzung von Discourse für diesen Zweck die bevorzugte Methode wäre, aber darf ich vorschlagen, vielleicht eine Hugo-Website oder eine Jekyll-Website zu verwenden, bei der die Dokumente als Dateien in einem GitHub-Repository vorliegen, zu dem jeder Pull Requests einreichen kann. Wenn Ihnen keines dieser beiden Systeme zusagt, gibt es viele weitere Dokumentations-Systeme für GitHub-Repositories in den unterschiedlichsten Varianten.
Oh, die Versionsverwaltung funktioniert bei Discourse ziemlich gut, sogar sehr gut. Kombiniert man das mit der Zugriffssicherheit für Kategorien, ergibt sich etwas, auf das wir stolz sind und das wir nutzen
Nur zur Info: Ich arbeite langsam daran, #howto:sysadmin zu bereinigen, stelle sicher, dass jeder Beitrag aktuell und relevant ist, und lasse sie dann nach auto-delete-posts-after verschieben. Es sieht so aus, als wären die meisten davon hier als „Erweiterte Konfiguration
Stimme voll und ganz zu. Multisite ist eine super super fortgeschrittene Konfiguration und etwas, das wir auf Meta kaum unterstützen.
Das ist korrekt. Discourse + das Docs-Plugin + einige zusätzliche Anpassungen. Die Nutzung von Discourse ist unsere bevorzugte Lösung dafür, aber ich erkenne auch die Vorteile einer Wiki-/SSG-Website.
Ich denke, Multisite ist weitgehend „unterstützt", aber man geht davon aus, dass, wenn man diesen Weg einschlägt, mehr von einem erwartet wird (z. B. muss man sich überlegen, was rebuild app in verschiedenen Kontexten bedeutet). Ich würde sagen, es ist „fortgeschritten", aber nicht „super, super fortgeschritten".
Zustimmung, dass tertiäre Kategorien und Unterverzeichnisse „super, super fortgeschritten" sind.
Vielleicht denke ich eher an Multisite mit Let’s Encrypt, das im Laufe der Jahre wiederholt Probleme bereitet hat und bei dem aktualisierte Dokumentation manchmal Wochen oder Monate auf sich warten ließ.
Ahh. Ja. Ich denke, das ist wahrscheinlich mittlerweile ziemlich stabil (ich glaube, die letzte Änderung betraf die Handhabung von Weiterleitungen in nginx), und ich habe einen Beitrag unter Multisite Configuration with Let's Encrypt and no reverse proxy - Documentation - Literate Computing Support, den ich hier bald veröffentlichen möchte (ich habe ihn am 2. Dezember 2020 geschrieben und zuletzt getestet). Aber bei Multisite ist man definitiv weitgehend auf sich allein gestellt. Ich denke, es macht überhaupt erst Sinn, wenn man mindestens 3 (vielleicht 10?) Sites betreibt, da es so scheint, als ob die meisten Leute, die glauben, sie wollten das, versuchen, mit einem einzelnen 1-GB-Droplet auszukommen.
Am hilfreichsten wäre es für mich, wenn Sie weniger Aufwand in die Strukturierung der Kategorie (Anleitungen) an sich stecken würden, sondern stattdessen eine bessere Struktur für die Dokumentation schaffen würden.
Ich schätze es sehr, wenn das Forum einfach flüssig bleibt, damit Benutzer Beiträge veröffentlichen können. Dafür ist es meiner Meinung nach zentral, dass es gute Hauptkategorien gibt und Benutzer in die richtige davon posten. Wenn Unterkategorien jedoch komplex werden und es für Benutzer wichtig wird, in die richtige Unterkategorie zu posten oder in welcher Unterkategorie sie nach Inhalten suchen sollen, finde ich das eher störend.
Derzeit spiegeln Sie die Forumseinrichtung praktisch in der Dokumentation wider:
Warum nutzen die Mitarbeiter nicht einige nur für Mitarbeiter zugängliche Tags, um die Dokumentation zu kuratieren und zu strukturieren, wie zum Beispiel ‘docs-getting-started’, ‘docs-setup’ – mit Inhalten von überall im Forum? Dann könnten Sie eine Dokumentationsseite einrichten, die mehr ist als nur ein Spiegel des Forums, sondern ein ordentlich kuratiertes Inhaltsverzeichnis hat, wie zum Beispiel:
Das ist genau die Idee hier, @manuel! Wir planen, einige Möglichkeiten zu schaffen, um nach diesen Arten von Anleitungen einfach zu filtern, aber gleichzeitig die Filter beizubehalten, die bereits im Docs-Plugin vorhanden sind. Die Organisation dieser Anleitungen in spezifische Tags ist der erste Schritt.
