Seminar openCode – Intensivseminar Nachnutzung, Governance und Veröffentlichung

Von einer geeigneten Software zur verlässlich gepflegten Veröffentlichung führen mehrere fachliche und organisatorische Schritte. Das Intensivseminar verbindet diese Schritte in einem gemeinsamen Verwaltungsfall. Nachnutzung, Rechteklärung, Lizenzkennzeichnung, Metadaten, Dokumentation und Beteiligung werden aufeinander abgestimmt. So wird sichtbar, welche Informationen und Entscheidungen jeweils vorliegen müssen, damit ein Projekt nachvollziehbar freigegeben und von anderen Organisationen verstanden werden kann.

Das Angebot bündelt die Einzelseminare zu Grundlagen und Nachnutzung, Lizenzen und Governance, Softwareveröffentlichung, Dokumentation sowie Konsultationsprozessen. Vorbereitete technische Vorlagen und ein einheitlicher Fall vermeiden wiederholte Einrichtungsschritte. Die fachliche Prüfung bleibt dennoch sichtbar: Werkzeugvalidierung, Entscheidung über Rechte und organisatorische Freigabe sind verschiedene Arbeitsschritte. Zusammen mit dem technischen Intensivseminar werden alle Themengebiete des Einzelprogramms behandelt. Für eine vertiefte Bearbeitung einzelner Rollenaufgaben stehen die jeweiligen Einzelseminare zur Verfügung.

Gebündelte Themen

Das Intensivseminar verbindet die folgenden Einzelangebote in einem gemeinsamen Projekt:

• openCode – Grundlagen, Orientierung und Nachnutzung
• openCode – Lizenzen, Freigabeprozesse und Governance
• openCode – Softwareveröffentlichung und publiccode.yml
• openCode – Dokumentation mit GitLab Pages, easyPDF und easyWebsite
• openCode – Konsultationsprozesse und Community-Management

Inhaltsübersicht

1. Plattform, Auswahl und Nachnutzung
2. Rechte, Lizenzen und Freigabeverantwortung
3. Kennzeichnung und Beitragsregeln
4. Veröffentlichung und Metadaten
5. Dokumentation als Website und PDF
6. Konsultation und gemeinsame Pflege
7. Gemeinsame Veröffentlichungswerkstatt

1. Plattform, Auswahl und Nachnutzung

• Rolle des ZenDiS und Aufbau von openCode einordnen; öffentliches Lesen, Registrierung, 2FA und berechtigte Mitarbeit unterscheiden.
• Projektinformationen, Dokumentation, Wartung, Qualitätsmerkmale und technische Voraussetzungen für eine Auswahlentscheidung auswerten.
• Anforderungen, Kostenbestandteile, Pilotumfang und Verantwortlichkeiten in einer nachvollziehbaren Nachnutzungsplanung zusammenführen.

Praxisübung: Zwei Projektprofile vergleichen, eine begründete Vorauswahl treffen und offene Prüffragen für einen Pilotversuch zuweisen.

2. Rechte, Lizenzen und Freigabeverantwortung

• Eigenbestand, Auftragsentwicklung und Drittbeiträge inventarisieren und deren Herkunft sowie Veröffentlichungsbefugnis untersuchen.
• Typische Lizenzpflichten und mögliche Widersprüche anhand vorgegebener Beispiele erkennen; fachliche Prüfaufträge formulieren.
• Projektverantwortung, Lizenzprüfung und Veröffentlichung mit dokumentierten Freigaben, Ausnahmen und Wiederholungsprüfungen verbinden.

Praxisübung: Einen Freigabefall vorbereiten, unvollständige Rechtebelege markieren und die erforderlichen Entscheidungen den zuständigen Rollen zuordnen.

3. Kennzeichnung und Beitragsregeln

• REUSE, SPDX-Bezeichner, Copyright-Angaben und Lizenztexte in einem überschaubaren Repository konsistent pflegen.
• Beitragsregeln sowie die unterschiedlichen Zwecke von DCO und CLA erläutern und auf den Fall beziehen.
• Komponenten- und Lizenzangaben einer SBOM einordnen und technische Prüfbefunde von fachlichen Rechtefragen unterscheiden.

Praxisübung: Fehlende Kennzeichnungen ergänzen, den Beispielbestand mit REUSE prüfen und einen simulierten Drittbeitrag nachvollziehbar bewerten.

4. Veröffentlichung und Metadaten

• README, Lizenzangaben, Wartungsmodell und Projektbeschreibung auf Konsistenz prüfen.
• publiccode.yml mit der vom Editor unterstützten Schemafassung erstellen, validieren und im Hauptverzeichnis des Projekts ablegen.
• Sprachvarianten, Logos und Screenshots kontrollieren; zeitversetzte Verzeichnisaufnahme und spätere Pflege berücksichtigen.

Praxisübung: Eine geprüfte Metadatendatei erstellen und anhand eines bestehenden Beispieleintrags die Darstellung sowie typische Fehler kontrollieren.

5. Dokumentation als Website und PDF

• Markdown-Struktur, verständliche Navigation und redaktionelle Konventionen für das gemeinsame Dokument festlegen.
• Vorbereitete GitLab-Pages-, easyWebsite- und easyPDF-Abläufe verwenden und ihren jeweiligen Veröffentlichungsstand prüfen.
• Überschriften, Tabellen, Bildbeschreibungen und Lesereihenfolge prüfen; automatische Generierung mit manueller Qualitätskontrolle verbinden.

Praxisübung: Das Projektdokument überarbeiten, Web- und PDF-Ausgaben erzeugen und einen absichtlich eingebauten Strukturfehler in beiden Ausgaben beheben.

6. Konsultation und gemeinsame Pflege

• Beteiligungsziel, Rollen, Zugang, Fristen und Moderationsregeln festlegen und einen vorbereiteten Konsultationsbaukasten anpassen.
• Issues und Änderungsvorschläge sichten, zusammenführen und fachlich entscheiden; Annahme oder Ablehnung nachvollziehbar begründen.
• Freigegebenen Dokumentstand, Kommunikation, offene Aufgaben und laufende Community-Pflege aufeinander abstimmen.

Praxisübung: Eine Konsultationsrunde mit mehreren Rollen durchführen und einen strittigen Vorschlag durch Diskussion, Entscheidung und Dokumentenänderung führen.

7. Gemeinsame Veröffentlichungswerkstatt

• Auswahlentscheidung, Rechteprüfung, Projektmetadaten und Dokumentation anhand eines gemeinsamen Prüfbogens kontrollieren.
• Technische Fertigstellung und organisatorische Veröffentlichungsfreigabe sichtbar voneinander unterscheiden.
• Verantwortliche für Nachpflege, Rückfragen, Änderungen und erneute Freigabe benennen.

Praxisübung: Den Fall im Rollenwechsel abnehmen, fehlende Angaben korrigieren und einen vollständig vorbereiteten Veröffentlichungsstand zusammenstellen.

Schulungsumgebung

Der Kunde stellt eine Übungsgruppe mit passenden Rollen, freigegebene Projekt- und Dokumentdaten sowie vorbereitete Laufzeiten für REUSE, GitLab Pages, easyPDF und easyWebsite bereit. Der Konsultationsbaukasten ist eingerichtet. Rechtebeispiele werden anonymisiert und öffentliche Ausgaben vorab organisatorisch freigegeben.