Skip to content

Developer_3.x Guidelines

matthiaskissler edited this page Sep 29, 2022 · 2 revisions

Guidelines

Allgemein

  • Arbeit in GIT nach dem Forking Workflow
  • Einhaltung der Coding Guidelines
  • Zu entwickelnde Features sollten als Issue vor dem Pull-Request bekannt gemacht werden
  • Fork Branch Hinweise:
  • Jeder Branch sollte in sich geschlossen sein und nur genau die Änderungen beinhalten, die nötig sind
  • Können zum Bearbeiten eines Features entweder in privaten, persönlichen Forks oder in einem Fork einer GitHub-Organisation durch mehrere Personen durchgeführt werden

Commits

  • In englischer Sprache, Orientierung an bspw. http://chris.beams.io/posts/git-commit/
  • Commits sollten nur die Änderungen enthalten, die auch in der Commit Nachricht beschrieben sind
  • Eher viele kleine Commits mit jeweils wenigen Änderungen als wenige, große / umfangreiche Commits

Pull-Requests

  • sollten idealerweise von einer anderen Person als dem Ersteller auf GitHub begutachtet (review changes) werden.
  • müssen zum Zeitpunkt des Merges fehlerfrei integrierbar sein. Konflikte müssen vom Ersteller gelöst werden.

Branch Unterscheidung

  • Unterscheidung bezieht sich auf die GitHub Projekte Kitodo.ContentServer, Kitodo.Production und Kitodo.UGH
  • Branch 2.x: ist die Weiterentwicklung der alten Goobi.Production Community Edition (Version 1.11.x) unter dem neuen Namen Kitodo.Production und wird als Version 2.x weiter geführt
  • Branch master: die unter dem DFG Projekt geförderten Weiterentwicklung von Kitodo.Production findet hier statt und enthält auch die darauf basierenden betriebenen Entwicklungen
Clone this wiki locally