Table of Contents

Um der JVx Community zu helfen, mußt du dich entscheiden, wobei du helfen möchtest. Das kann z.B die Erstellung von Dokumenation, die Übersetzung von Informationen, Schreiben von Presseberichten, Veranstaltungen planen, Erstellen von Beispielanwendungen oder die Weiterentwicklung von JVx betreffen.

Abhängig vom Thema, gibt es unterschiedliche Abläufe und Regeln die uns die Zusammenarbeit erleichtern. Die Regeln werden innerhalb der Community erarbeitet und müssen von jedem Mitglied eingehalten werden.

Verhaltensregeln

Diese Regeln betreffen Dein Verhalten innerhalb der JVx Community im Umgang mit Foren, Mailinglisten, Blogs, Bug Trackern oder Community Events.

Wo finde ich Hilfe?

Die erste Anlaufstelle für Fragen ist das Forum.

Ein Bug wird im Support System erfasst.

Der Source Code

Wenn du dich an der Entwicklung von JVx beteiligen möchtest, ist das Source Code Repository die erste Anlaufstelle. Die Repositories werden auf SourceForge gehostet und der Checkout gelingt mit folgendem SVN Befehl:

JVx
svn checkout https://svn.code.sf.net/p/jvx/code/trunk/ jvx

Im Repository sind alle notwendigen Source Files und Projekt-Dateien enthalten. Die Projekt-Dateien können mit Eclipse.

Die Erstellung der Bibliotheken wird mit ANT Buildfiles durchgeführt. Diese sind in den jeweiligen Projekten enthalten.

Source Code beisteuern

Das Enterprise Application Framework - JVx - ist Open Source. Dadurch kann sich jeder Entwickler auch an der Entwicklung beteiligen und einzigartige Features integrieren. Doch bevor nun gleich die Lieblings IDE angeworfen wird um das erste Feature zu entwickeln, sollten die Regeln für die Zusammenarbeit beachtet werden. Dadurch wird sichergestellt, daß die hohen Qualitätsansprüche erfüllt werden können. Weiters ist ein Contributor License Agreement erforderlich damit der Code, ohne Bedenken, in JVx integriert werden kann.

Code Style

Ein einheitlicher Code Style soll sicherstellen das der Source Code von jedem Entwickler auf die gleiche Art und Weise gelesen und interpretiert werden kann. Wir wollen jedoch nicht mehr Aufwand in die Formatierung des Source Codes investieren als in die tatsächliche Entwicklung. Aus diesem Grund verwenden wir unterschiedliche Tools für die langweiligen Aufgaben und konzentrieren uns voll auf die spannenden Tätigkeiten.

Die Style Vorgaben und Tools unterscheiden sich je nach Programmiersprache und Projekt: Java Style, C# Style, Objective-C Style

Code übermitteln

Wir freuen uns auf jeden Beitrag!
Folgende Schritte sind für die Übermittlung notwendig:

  1. Eine Übermittlung muss immer zu einem Ticket im Support System erfolgen. Sollte noch kein Ticket vorhanden sein, so muss ein neues erstellt werden. Jedes Ticket stellt genau eine in sich geschlossene Änderung/Erweiterung dar.
  2. Falls ein bereits vorhandenes Ticket bearbeitet wird, ist die Abstimmung zwischen den Mitgliedern erforderlich
  3. Der Source Code Style ist zu berücksichtigen
  4. Unit Tests sind vorhanden
  5. Ein Contributor License Agreement ist erforderlich
  6. Den Source Code direkt beim Ticket hinterlegen, mit einer eindeutigen Anmerkung

Wie werde Ich JVx Committer?

Wenn Du mit den Mechanismen von JVx vertraut bist und bereits den ein oder anderen Source Code erfolgreich übermittelt hast, spricht nichts mehr dagegen ein offizieller JVx Committer zu werden. Natürlich musst Du Dir erst mal Deine Lorbeeren verdienen in dem du unsere zuvor genannten Regeln befolgst.

Contributor License Agreements (CLA)

Wir benötigen ein Contributor License Agreement um deinen Source Code in JVx integrieren zu dürfen. Dadurch werden Deine und unsere Rechte geschützt.

Du arbeitest als Einzelperson an JVx
Du arbeitest für ein Unternehmen das dir erlaubt an JVx zu arbeiten