Beiträge zur neuen Joomla!-Dokumentation sind sehr willkommen.

Wenn mitgewirkt werden soll, bitte Folgendes tun:

  • Anmelden durch Klicken auf die (blaue) Schaltfläche oberhalb des linken Menüs mit der Aufschrift „LOGIN (click here)“.
    Man wird zum Joomla! Identity Portal weitergeleitet, wo die Anmeldung mit dem Joomla-Community-Benutzerkonto erfolgen kann. Das ist dasselbe Benutzerkonto auf identity.joomla.org, das auch für die Anmeldung bei Mattermost verwendet wird.
  • Falls noch kein Benutzerkonto auf identity.joomla.org besteht, kann eines erstellt werden.
  • Die Anmeldung mit Autorenrechten ist nun möglich. Eventuell muss man sich ab- und wieder anmelden, bevor die Autorenrechte genutzt werden können.
  • Beiträge zur Benutzerdokumentation sind sehr willkommen! Einfach einen Beitrag erstellen.
  • Bei Fragen ist man im Kanal Documentation Suggestions auf Mattermost herzlich willkommen, und wir kümmern uns darum.
  • Einfach mit dem Schreiben beginnen! Niemand sieht den Entwurf, bevor er zur Überprüfung eingereicht wird. Man muss sich keine Gedanken über die genaue Platzierung des Beitrags machen: Das übernehmen die Documentation Curators.

Make-it-Happen-Sitzung, Joomla World Conference

Am Samstag, den 17. Oktober, finden bei der Joomla World Conference Make it Happen Sessions statt. Bei der Session zur Benutzerdokumentation liegt der Fokus auf dem Hinzufügen von Tutorials zum Site-Aufbau.

Über Tutorials

Es wird an einer Reihe von Tutorials gearbeitet. Diese finden sich unter Tutorials. Bisher wurde hauptsächlich an Tutorials zum Content-Management gearbeitet.

  • Ein Tutorial ist fast nie vollständig. Es zeigt nur einen Weg, etwas zu tun, nicht alle alternativen Möglichkeiten dazu.
  • Hauptziel ist es, bestimmte Konzepte zu vermitteln. Keine langen Erklärungen. Ein Tutorial bedeutet Lernen durch Tun.
  • Das Tutorial bietet eine Reihe von Schritten, die der Leser wiederholen kann, was zu einem reproduzierbaren Ergebnis führt. Der Weg ist jedoch wichtiger als das Ergebnis.
  • feste Reihenfolge:
    • Beginn mit einer Übersicht der Voraussetzungen: welche Tutorials vorher durchgeführt werden müssen.
    • Dann eine Zusammenfassung, worum es in diesem Tutorial geht (kurze Beschreibung des Beispiels).
    • Dann die zu befolgenden Schritte
    • Abschluss mit einem Fazit: Zusammenfassung der behandelten Konzepte.

Alle Beiträge sind auf Englisch verfasst; das ist unsere Grundsprache. Zunächst liegt der Fokus auf dem Inhalt. Diesen Sommer wird an einem Projekt gearbeitet, um automatische Übersetzungen bereitzustellen, die von Übersetzern überprüft werden; sie können auch sprachspezifische Screenshots liefern. Die Umsetzung ist für September geplant.

Die Hauptaufgabe besteht darin, anderen zu zeigen, wie man Joomla! nutzt. Man leitet sie mit seinem Wissen an. Daher der Name Knowledge Navigator. Für Beiträge können Holopin-Abzeichen verdient werden.

Lizenz

Alle Beiträge zur Dokumentation unterliegen der Joomla! Electronic Documentation License.