Theme-Anpassungen sicher umsetzen

Technische Theme-/UI-Anpassungen upgrade-fähig planen und dokumentieren.

Moodle AFANDI Standard Übergabefähig dokumentieren Review zyklisch

Kurz erklärt

Diese Seite beschreibt den Arbeitsstandard für Theme-Anpassungen sicher umsetzen – mit Fokus auf konkrete Entscheidungen statt allgemeiner Leitlinien.

Zentral sind hier vor allem upgrade-fenster und freigabegrenze und go/no-go-kriterien, damit Teams denselben Maßstab anwenden.

Nachvollziehbar wird der Standard erst durch verlinkte Nachweise wie upgrade-runbook und durch dokumentierte Grenzfälle/Ausnahmen.

PraxisfokusThemenspezifischPrüfbar

Wann diese Seite hilft

Typische Situationen, in denen diese Seite als Arbeitsdokument Mehrwert bringt – und wo eine andere Doku passender ist.

Typische Einsätze

  • wenn Theme-Anpassungen sicher umsetzen als wiederverwendbarer Moodle-Standard mit klaren Vorgaben zu zielversion, wartungsfenster und freeze dienen soll
  • wenn Autor:innen/Trainer:innen bei upgrade-fenster und freigabegrenze uneinheitlich arbeiten
  • wenn Qualitätssicherung und Freigaben mit upgrade-runbook nachvollziehbar dokumentiert werden sollen
  • wenn Support- oder Kursfeedback auf einen typischen Stolperpunkt hindeutet (z. B. upgrade-fenster ohne klare abbruchkriterien)

Eher nicht passend bei

  • wenn es bei Theme-Anpassungen sicher umsetzen nur um einen einmaligen Einzelfall ohne Standardisierungsbedarf geht
  • wenn ein detailliertes Projektticket oder eine technische Schritt-für-Schritt-Anleitung gepflegt werden soll

Empfohlener Ablauf

Pragmatische Reihenfolge, die in der Praxis funktioniert – vom Scope bis zum Review.

  1. Use Case und Zielgruppe von Theme-Anpassungen sicher umsetzen kurz beschreiben; daraus Scope und erwartetes Lernergebnis ableiten.
  2. Standardaufbau/-konfiguration festlegen, insbesondere upgrade-fenster und freigabegrenze und go/no-go-kriterien.
  3. Mit Testnutzer oder Referenzkurs prüfen, ob zielversion, wartungsfenster und freeze in der Praxis funktionieren.
  4. Qualitätssicherung/Freigabe durchführen und Artefakte wie upgrade-runbook verlinken.
  5. Nach Livegang Rückmeldungen auswerten und Fehlerbilder wie „Upgrade-Fenster ohne klare Abbruchkriterien“ als Stolperfalle ergänzen.

Entscheidungsregeln

Hinweis: Bitte keine allgemeinen Doku-Regeln hier wiederholen. Auf dieser Seite geht es um die konkreten Regeln und Ausnahmen für Theme-Anpassungen sicher umsetzen. Zentrale Leitlinie.

Theme-Anpassungen sicher umsetzen ist gut dokumentiert, wenn Regeln, Grenzfälle und Nachweise so konkret sind, dass Teams damit ohne Zusatzabsprachen arbeiten können.

Standardfall

Für Theme-Anpassungen sicher umsetzen zuerst den Anwendungsbereich konkret machen: Zielversion, Wartungsfenster und Freeze.

Freigabe & Rollen

Entscheidungen zu upgrade-fenster und freigabegrenze und go/no-go-kriterien nicht implizit lassen, sondern Rollen und Freigaben explizit benennen.

Grenzfälle

Ausnahmen nur zulassen, wenn sie den Standard nicht aufweichen; besonders relevant sind hier vorabtests in staging.

Kontrollpunkt

Prüfbar ist die Regel erst, wenn upgrade-runbook und testprotokolle sauber verlinkt sind.

Was dokumentiert werden soll

Hier nur die spezifischen Inhalte zu Theme-Anpassungen sicher umsetzen pflegen; allgemeine Doku-Regeln bleiben in der zentralen Leitlinie. Zentrale Leitlinie.

Die Seite ist dann gut, wenn eine Vertretung den Standard anwenden oder prüfen kann, ohne erst Personenwissen einsammeln zu müssen.

Definitionen

Begriffe, Scope und Grenzen zu Theme-Anpassungen sicher umsetzen konkretisieren – inklusive zielversion, wartungsfenster und freeze.

Standardkonfiguration / Prozess

Den Standard so notieren, dass upgrade-fenster und freigabegrenze und kommunikation an nutzergruppen eindeutig entschieden sind.

Belege

Artefakte direkt nennen und verlinken: Upgrade-Runbook, Testprotokolle, Go/No-Go-Entscheidung.

Review-Stand

Aktive Ausnahmen, letzte Änderung und nächster Review gehören auf die Seite – besonders bei Themen mit vorabtests in staging.

Typische Stolperfallen

Pflege hier echte Fallstricke aus der Praxis von Theme-Anpassungen sicher umsetzen; allgemeine Hinweise gehören in die zentrale Leitlinie. Zentrale Leitlinie.

  • Umfang driftet: Upgrade-Fenster ohne klare Abbruchkriterien.
  • Regel bleibt abstrakt: Nachtests decken nur Login ab.
  • Nachweis fehlt: Kommunikation kommt zu spät.
  • Ausnahme entgleist: Einzelfall-CSS ohne Governance wächst an.
Tipp: Lieber 3 konkrete Beobachtungen aus echten Fällen dokumentieren als eine lange allgemeine Liste.

Moodle-Referenz (offizielle Doku 5.1)

Kurze Verweise auf die offizielle Moodle-Dokumentation für Theme-Anpassungen sicher umsetzen. So bleibt diese Seite AFANDI-spezifisch und vermeidet doppelte Grundlagen.

Dokumentationsfokus

  • Theme-Anpassungen mit Upgrade-Risiko bewerten; Custom CSS/JS sauber versionieren.
  • UI-Pfad, Rolle und Testfall explizit notieren (nicht nur den gewünschten Endzustand).
  • Abweichungen von AFANDI-Standards separat markieren, damit Updates leichter reviewbar bleiben.
Hinweis: Moodle-Oberflächen, Pfade und Optionen können je nach Version, Theme und aktivierten Plugins abweichen. Deshalb immer Version, Rolle und Testkontext auf der Seite mitführen.

Prüfung & Pflege

Prüfe diese Seite gegen reale Vorgänge zu Theme-Anpassungen sicher umsetzen – nicht nur gegen den Wortlaut. Entscheidend ist, ob Standard, Ausnahmen und Nachweise im Alltag tragen.

  • Wurden Vorabtests vollständig durchgeführt?
  • War das Go/No-Go nachvollziehbar?
  • Gab es Nacharbeiten nach dem Upgrade?
  • Sind Customizations noch upgrade-fähig?

Prüf-Fokus für „Theme-Anpassungen sicher umsetzen“: Theme / UI; prüfe dabei insbesondere zielversion, wartungsfenster und freeze.

Sinnvolle Kennzahlen

Wenige Kennzahlen genügen – wichtig ist, dass sie Entscheidungen oder Verbesserungen auslösen.

Für „Theme-Anpassungen sicher umsetzen“ Kennzahlen direkt an upgrade-fenster und freigabegrenze und die häufigsten Praxisrisiken koppeln.

Upgrade-Erfolg

Upgrades ohne ungeplante Downtime-Verlängerung

Intervall: pro Release

Nacharbeitsaufwand

Anzahl/Umfang Tickets nach Upgrade

Intervall: pro Release

Kommunikationsvorlauf

Zeit zwischen Info und Wartungsfenster

Intervall: pro Release

Nächste Schritte

Ergänze jetzt die konkrete Entscheidung zu upgrade-fenster und freigabegrenze inkl. Verantwortlichen, Datum und Verweis auf upgrade-runbook.

Auf „Theme-Anpassungen sicher umsetzen“ als Nächstes besonders klar machen: welche zielversion, wartungsfenster und freeze im Standardfall gelten und welche Ausnahmen befristet sind.