AG Community-Arbeit

Infos zur AG Community-Arbeit

Konzeption und Aufbau der Moodle Knowledge Base

Moderation: Melanie Treitinger (Ruhr-Universität Bochum)

Themen

AG-Treffen: jeden ersten Mittwoch im Monat von 13-14 Uhr

Themen-Patenschaften

Die Aufgabe der Themen-Paten für die Knowledge Base besteht darin, neue Inhalte Korrektur zu lesen, und zwar sowohl in Hinsicht auf Rechtschreibung, Grammatik und Verständlichkeit als auch auf inhaltliche Richtigkeit.
Idealerweise wird die Patenschaft für ein Thema von 2-3 Personen übernommen.

Hauptkategorien Patenschaften / Redaktionsteam
Community
Didaktische Szenarien und Materialien
 Jasmin vom Brocke
E-Assessment
 Philipp Dorok
Entwicklung, Fehleranalyse und Debugging
 Melanie Treitinger
Moodle-Administration (Core)
 Klaus Steitz
Plugins, Infos und Konfiguration
 Christian Wolters
Server-Administration (Linux, Datenbanken, etc)
 Thorsten Bartel 

Redaktionsleitfaden

Redaktionsleitfaden Moodle an Hochschulen Knowledge Base

Redaktionsleitfaden für die Knowledge Base von Moodle an Hochschulen e.V.

https://kb.moodle-an-hochschulen.de

Ziel

Wir sammeln an einem zentralen Ort Wissen über Moodle, das in verschiedenen Kanälen zu finden oder aus
internen Quellen oder Erfahrungen stammt und von allgemeinem Interesse ist.

Zielgruppe

Unsere Zielgruppe besteht aus Hochschulakteuren (bewusst aber nicht direkt Lehrende und Studierende). Dazu
gehören z.B. Personen aus folgenden Bereichen:

Die Zielgruppe orientiert sich vor allem an den Angehörigen des Community-Kurses „Moodle an Hochschulen im
deutschsprachigen Raum“ (https://forum.moodle-an-hochschulen.de).

Die Inhalte sollen, sofern möglich, einer interessierten Öffentlichkeit ohne Beschränkung zugänglich sein.

Wie sollen die Inhalte angelegt werden?

Die Einträge sollen auf Deutsch und in eigenen Worten verfasst werden.

Eine Illustration durch Medien (z.B. Videos, Bilder, Screenshots oder Code-Beispiele) kann hilfreich sein.

Außerdem sind hilfreiche Links z.B. auf die offizielle Moodle-Doku oder den Moodle-Quellcode
(https://github.com/moodle/moodle) nützlich.

Jeder Eintrag soll mit einem oder mehreren Tags versehen werden.

Jeder Eintrag bekommt eine bzw. mehrere Autorensignaturen (von der/den Personen, die den Artikel verfasst
haben).

Die Namen sollen dabei mit der Profilseite im Moodle-an-Hochschulen-Moodle verlinkt werden.

Struktur der Inhalte

Regale

Regale versammeln Bücher, die thematisch zusammengehören.

Es gibt die Regale „Community“, „Didaktische Szenarien und Materialien“, „E-Assessment“, „Entwicklung,
Fehleranalyse und Debugging“, „Moodle-Administration (Core)“, „Plugins“, „Server-Administration“.

Bücher

Bücher enthalten Artikel zu einem bestimmten Thema, z.B. „Nutzerverwaltung“, „Support-Materialien“ oder
„Update-Management“.

Kapitel

Kapitel dienen der Strukturierung von Büchern und sind sinnvoll, sobald sich Unterthemen zusammenfassen
lassen. Beispiele:

Kapitel „Config-Settings“ mit den Unterseiten „Nützliche Config-Settings“ und „Geheime Config-Settings“ im Buch
„Moodle Konfiguration“.

Seiten

Überschriften: Die Hauptüberschriften eines Artikel sollen mit „Große Überschrift“ (= h2) formatiert werden.
Weitere Unterüberschriften dann hierarisch mit „Mittlere Überschrift“ (= h3), „Kleine Überschrift“ (= h4) und „Sehr
kleine Überschrift“ (= h5).

Vorteil: Wenn man die vorgegebenen Überschriften zur Strukturierung des Artikels nutzt, wird automatisch links
oben auf der Seite ein Inhaltsverzeichnis des Artikels erstellt. Außerdem werden dann die Anforderungen der
Barrierefreiheit erfüllt.

Kursive Formatierung für:

Code Formatierung für:

Nutzung von Tags

Hintergrund: Kommentare und Tags hängen mit ihrer Sichtbarkeit an der Sichtbarkeit der Seite – sie sind also für
die Rolle "Public" sichtbar, aber nicht bearbeitbar.

Alle Artikel sollen mit den passenden Tags versehen werden.

Eindeutigkeit und Einheitlichkeit: Bei der Verschlagwortung von Artikeln schlägt BookStack die bestehenden
Tags vor, wenn man anfängt zu tippen. Bitte darauf achten, keine unterschiedlichen Schreibweisen von Begriffen
zu verwenden!

Tags können Werte haben, mit denen man die Tags genauer beschreiben kann.

Der Tag „needs-enhancement“ kann bei Bedarf gesetzt werden (Werte z.B.: „Formatierung“, „Illustrationen“,
„Texterweiterung“).

Angabe von Quellen und Copyright

Wenn möglich, soll eine Quelle für die Informationen angegeben werden.

Für die Nutzung fremder Medien (z.B. Texte, Bilder und Code-Beispiele) gilt, dass die jeweiligen
Lizenzbedingungen beachtet werden müssen.

Alle Inhalte in der Knowledge Base unterliegen grundsätzlich der CC-Lizenz „CC BY-NC-SA“ (Teilen und
bearbeiten mit Namensnennung, Weiternutzung nur nicht kommerziell). In begründeten Fällen kann in Absprache
mit der AG Community-Arbeit davon abgewichen werden.

Inhalte wiederverwenden

Wenn Inhalte an mehreren Stellen gebraucht werden, müssen sie nicht mehrfach angelegt werden.

Es genügt, eine zweite Seite anzulegen und den Inhalt mit Eingabe von {{@page_id}} zu verlinken. Anzeigen der ID: Text in zu kopierendem Artikel markieren (Lesemodus, nicht beim editieren), es öffnet
sich ein modal, dort links auf das Link-icon klicken, dann springt die Anzeige auf die Text-ID um.

Dasselbe Prinzip ist auch mit Absätzen möglich.

Anleitung siehe https://www.bookstackapp.com/docs/user/reusing-page-content/

Hinweis: Die Original-Seite ist zu finden durch Eingabe von /link/xx, wobei xx die page_id bzw.
page_id#bkmrk-content-area ist!

Beispiel: /link/19 führt zu /books/buch-debugging/page/plugin-tool-userdebug

Themen-Patenschaften

Die Aufgabe der Themen-Paten besteht darin, neue Inhalte Korrektur zu lesen, und zwar sowohl in Hinsicht auf
Rechtschreibung, Grammatik und Verständlichkeit als auch auf inhaltliche Richtigkeit.

Idealerweise wird die Patenschaft für ein Thema von 2-3 Personen übernommen.

Patenschaften in tabellarischer Übersicht