OpenSDG Redakteurshandbuch
Willkommen im deutschsprachigen Handbuch für Redakteur:innen der OpenSDG-Plattform.
Diese Seite – erreichbar unter opensdg.de – richtet sich speziell an Kommunen in Deutschland, die OpenSDG für das Monitoring ihrer kommunalen Nachhaltigkeitsziele nutzen möchten.
Wichtig: Dies ist nicht die offizielle internationale OpenSDG-Webseite, sondern eine deutschsprachige Begleitdokumentation mit Fokus auf kommunale Praxis und redaktionelle Arbeit.
Was ist OpenSDG?
OpenSDG ist eine quelloffene Plattform zur Veröffentlichung und Visualisierung von SDG-Indikatoren (Sustainable Development Goals). Sie wurde international entwickelt und wird von zahlreichen Ländern und Städten eingesetzt.
Die Plattform erlaubt es Kommunen, ihre Daten selbstständig zu pflegen und der Öffentlichkeit zugänglich zu machen – ganz ohne eigene Backend-Systeme oder Datenbanken.
Offizielle Ressourcen
- 🌐 Projektwebseite (international): open-sdg.org
- 📚 Technische Dokumentation: readthedocs.io
- 💻 Quellcode auf GitHub: open-sdg/open-sdg
Diese Seiten enthalten vertiefende technische Hinweise zur Installation, Konfiguration und Anpassung.
Was bietet dieses Handbuch?
Dieses Handbuch richtet sich an kommunale Redakteur:innen, die Inhalte auf einer OpenSDG-Instanz pflegen. Es erklärt leicht verständlich:
- Wie OpenSDG funktioniert
- Warum OpenSDG besonders für Kommunen geeignet ist
- Wie der Einstieg gelingt und welche Voraussetzungen erfüllt sein sollten
- Welche Rollen es gibt und wer was macht
- Wie aus einer Idee eine funktionsfähige Plattform wird
- Was bei IT-Sicherheit und Datenschutz beachtet werden muss
Was finde ich wo?
Einführung
Eine grundlegende Einführung in die Idee und Funktionsweise von OpenSDG. Was kann die Plattform und für wen ist sie gedacht?
Argumente, warum sich OpenSDG besonders für kommunale Nachhaltigkeitsberichterstattung eignet.
Technische und organisatorische Voraussetzungen und erste Schritte für neue Projekte.
Welche Rollen gibt es in einem OpenSDG-Projekt, und wie arbeiten sie zusammen?
Der typische Projektverlauf von der Planung bis zur fertigen Instanz.
IT-Sicherheit und Datenschutz in OpenSDG
Wichtige Hinweise zur sicheren Umsetzung und datenschutzkonformen Nutzung.
Arbeiten mit OpenSDG
Datensätze ergänzen oder aktualisieren
Wie Daten für einzelne Indikatoren als CSV-Dateien gepflegt und strukturiert werden.
Indikatoren bearbeiten oder anlegen
Aufbau und Bedeutung der YAML-Dateien in _indicators/ inklusive Beispiel und Tabelle.
Wie die Übersetzungsschlüssel funktionieren und wie eigene Begriffe übersetzt werden.
Wie Seiten wie Startseite, News oder Impressum im Site-Repository angepasst werden.
Redaktionelle Best Practices
Schreibstil & Barrierefreiheit
Empfehlungen für einen klaren, inklusiven und leicht verständlichen Sprachstil.
Struktur & Dateiaufbau verstehen
Einblick in den Aufbau der Repositories und das Zusammenspiel von YAML, CSV und Markdown.
Typische Stolperfallen und wie man sie erkennt, z. B. bei CSV-Trennzeichen und Dezimalstellen.
Mitwirken
Schritt-für-Schritt-Anleitung zur Mitarbeit in einer konkreten OpenSDG-Instanz über GitLab oder GitHub.
Wie gute Beiträge aussehen, was Qualitätssicherung bedeutet und worauf man achten sollte.
Hintergrund & Weiterführendes
Kurze Erklärungen wichtiger Begriffe wie SDG, YAML, Repository oder Disaggregation.
Verweise auf weiterführende Ressourcen und relevante Partnerseiten.
Verweis zur offiziellen technischen Doku
Die zentrale, englischsprachige Dokumentation mit allen Funktionen und Erweiterungen.
Unterstützung & Mitmachen
Dieses Handbuch wird offen gepflegt. Du findest es im GitLab-Projekt unter:
➡️ https://gitlab.opencode.de/open-sdg-germany/dokumentation
Bei Fragen oder Ergänzungen kannst du gerne ein Issue erstellen oder einen Merge Request einreichen.
OpenSDG ist eine starke Lösung – wenn sie gut erklärt ist. Dieses Handbuch hilft dir, direkt loszulegen.