Seminar openCode – Kompaktseminar: Von der Orientierung zum gemeinsamen Projekt

Das Kompaktseminar schafft eine gemeinsame Arbeitsgrundlage für Teams, die openCode in einem ersten Projekt einsetzen möchten. Ein vorbereitetes Verwaltungsbeispiel macht den Weg von der Orientierung bis zum abgestimmten Projektstand nachvollziehbar. Fachliche und technische Rollen arbeiten am selben Fall und erkennen, welche Informationen für Auswahl, Bearbeitung, Prüfung und Freigabe benötigt werden. Die Browseroberfläche steht im Mittelpunkt, damit auch Beteiligte ohne bisherige Git-Routine aktiv mitarbeiten können.

Die Übungen konzentrieren sich auf einen überschaubaren Kernprozess. Eine Änderung wird beschrieben, im Projekt umgesetzt, gemeinsam geprüft und mit passenden Metadaten sowie Dokumentation verbunden. Vorbereitete Pipelines und Berichte veranschaulichen automatisierte Qualitätsprüfungen. Dabei bleibt erkennbar, welche Arbeiten das Team bereits selbst durchführen kann und für welche Aufgaben vertiefte Fachkenntnisse benötigt werden. Das Seminar eignet sich besonders für den gemeinsamen Projektauftakt und die anschließende Auswahl der rollenbezogenen Vertiefungsseminare.

Inhaltsübersicht

1. Orientierung und Projektentscheidung
2. Gemeinsame Bearbeitung in GitLab
3. Verantwortung, Lizenz und Freigabe
4. Metadaten und Softwareverzeichnis
5. Automatisierte Prüfung verstehen
6. Dokumentation und Beteiligung verbinden

1. Orientierung und Projektentscheidung

• Aufbau und Zweck von openCode, Rolle des ZenDiS und Möglichkeiten zur Nachnutzung verstehen.
• Zugangsvoraussetzungen, Registrierung, 2FA und berechtigte Mitarbeit auf den gemeinsamen Übungsfall beziehen.
• Projektinformationen, Dokumentation, Wartung und technische Anforderungen als Grundlage einer begründeten Vorauswahl prüfen.

Praxisübung: Zwei vorbereitete Projektprofile auswerten und die Auswahl anhand fachlicher Anforderungen sowie offener Prüffragen begründen.

2. Gemeinsame Bearbeitung in GitLab

• Repository, Datei, Commit und Branch anhand einfacher Beispiele verstehen und in der Browseroberfläche nachvollziehen.
• Issues mit Akzeptanzkriterien formulieren und eine kleine Dokumentänderung als Änderungsvorschlag einreichen.
• Reviewkommentare bearbeiten, Zuständigkeiten klären und einen abgestimmten Stand übernehmen.

Praxisübung: Eine Änderung vom Issue über die Bearbeitung bis zum geprüften Merge Request durchführen und die Historie gemeinsam nachvollziehen.

3. Verantwortung, Lizenz und Freigabe

• Rollen und Mitgliedschaften anhand einer vorbereiteten Gruppe einordnen und Schreib- von Leserechten unterscheiden.
• LICENSE, Herkunftsangaben und Komponenteninformationen auf Vollständigkeit prüfen; offene Rechtefragen erkennen.
• Freigabeverantwortung und Pflegezuständigkeit festlegen und den Zweck strukturierter Kennzeichnung mit REUSE und SPDX erläutern.

Praxisübung: Einen einfachen Freigabebogen ausfüllen und zwischen korrigierbaren Dokumentationsmängeln und fachlich zu klärenden Fragen unterscheiden.

4. Metadaten und Softwareverzeichnis

• Projektbeschreibung, Wartungsangaben und Veröffentlichungsstand für die publiccode.yml zusammenstellen.
• Eine vorbereitete Metadatendatei im openCode-Editor bearbeiten, validieren und kontrolliert im Repository ablegen.
• Verzeichniseintrag, Logo, Beschreibung und zeitversetzte Aktualisierung anhand eines Beispielbestands prüfen.

Praxisübung: Die Metadaten des Übungsprojekts vervollständigen und einen eingebauten Schema- oder Pfadfehler beheben.

5. Automatisierte Prüfung verstehen

• Jobs und Status einer vorhandenen CI/CD-Pipeline lesen und einen fehlerhaften Lauf von einem erfolgreichen Lauf unterscheiden.
• DevGuard-Bericht, Komponentenliste, Qualitätsbadges und SBOM-Darstellung in ihren unterschiedlichen Zwecken einordnen.
• Quellstand, Artefakt und Prüfergebnis zuordnen; Zuständigkeiten für Korrektur, Nachtest und Freigabe bestimmen.

Praxisübung: Einen vorbereiteten Analysefall bewerten und die Freigabe anhand von Pipeline-Ergebnis und fachlicher Bewertung begründet zurückstellen oder empfehlen.

6. Dokumentation und Beteiligung verbinden

• Markdown-Inhalte in einer vorbereiteten Dokumentstruktur pflegen und Web- sowie PDF-Ausgaben mit den vorhandenen Werkzeugen ansehen.
• Konsultationsbeiträge als Issues und Änderungsvorschläge strukturieren und eine fachliche Entscheidung dokumentieren.
• Weitere Qualifizierung für Administration, Runnerbetrieb, Dokumentation und Projektmigration anhand der Rollenaufgaben planen.

Praxisübung: Eine kurze Konsultationsrunde durchführen, eine Dokumentänderung übernehmen und den freigegebenen Projektstand gemeinsam prüfen.

Schulungsumgebung

Der Kunde stellt Browserarbeitsplätze, vorab freigeschaltete Übungskonten und ein vollständig vorbereitetes Repository mit Pipeline, Metadaten, Dokumentausgabe und Analyseberichten bereit. Die Schreibberechtigungen sind vor Beginn zu prüfen. Freigegebene Beispieldaten ermöglichen die Mitarbeit aller Rollen ohne Eingriffe in produktive Projekte.