Submitting code to OpenSim/de - Revision history

Manni at 21:24, 16 July 2018

2018-07-16T21:24:26Z

Manni at 21:23, 16 July 2018

2018-07-16T21:23:05Z

Chris Weymann: übersetze

2015-07-14T13:12:10Z

übersetze

Chris Weymann: create german version of this page

2015-07-14T12:49:21Z

create german version of this page

New page

__NOTOC__
{{Quicklinks|}}
{{InArbeit|Chris Weymann}}

* '''Before you begin, please review our [[Contributions Policy]]'''.

* Not all patches will make it into OpenSimulator. To keep a lid on code complexity, OpenSimulator is not trying to be a 'batteries included' project. Things that can't be considered core functionality are better implements as an external region module. If extra hooks/events are needed to make these work then patches for those are very welcome.

* Please review the [[Coding standards]] and stick to them in your patch. The only exception should be if the surrounding code does not conform to these guidelines, in which cases its okay to be consistent with the code already in the file. If a patch does not follow the guidelines we will ask for it to be changed.

Code is submitted to OpenSimulator via patches attached to entries in our [http://opensimulator.org/mantis/my_view_page.php Mantis bug tracker]. One way to generate these is by using the Git command line

git format-patch <commit hash>^!

This will package up all your git commit changes into a nice easily appliable file.

* Please run the automated tests (via "nant test" on the command line) before submitting your patch. Patches that add new tests (either to test accompanying patch code or to test existing code) are very welcome.

* Please put only one logical change in a patch at a time. Patches that contain more than one logical change tend to be larger, more complex and hence take more time to be applied. At worse, developers will tend not to look at them because it's hard to disentangle all the possible effects.

* In your Mantis, the title line should ideally start with [PATCH]. When you've opened it, change the state to patch included. Once you've put in on a Mantis, you may want to hop on the IRC channels and mention it someone there (though at the moment we're pretty good at getting round to these, since e-mails about newly opened mantis entries are sent to developers automatically).

* Once you've submitted your patch please move the Mantis entry into the '''Patch Included''' state to let us know there's a patch waiting to be reviewed. It might take a bit longer to see a mantis entry with a patch if it's not in this state (and in unfortunate rare cases it may be missed altogether for a period).

* General turnaround time for patch review is a week. though, it could be up to two weeks depending on the situation. If you want to chat about a patch (or remind people that it exists after a week has gone by), please feel free to pop into #opensim-dev on IRC or send an e-mail to the opensim-dev ailing list.

* When a patch is reviewed, it will either be applied (in which case, thanks very much!) or the Mantis entry will be changed to the "Patch feedback" state with comments from developers/interested parties. If you revise the patch in light of the discussion, please then change the state back to "Patch Included".

* If you're looking for an initial piece of code to do, the bugs in Mantis are a very good starting point. You may want to see if there's anybody on IRC to discuss the difficulty of a particular bug (they do vary, sometimes in unexpected ways).

[[Category:Development]]

← Older revision		Revision as of 21:24, 16 July 2018
Line 56:		Line 56:

	[[Category:Development]]		[[Category:Development]]
		+
		+	[[Category:German Translations]]

@@ Line 4: / Line 4: @@
-* '''Bevor du anfängst, lese bitte unsere [[Contributions Policy/de|Mitwirkungs-Bedinungen]]'''.
+== Überblick ==
-* Nicht alle patches schaffen es in OpenSimulator.
+'''Bevor Sie beginnen, lesen Sie bitte unsere [[Contributions Policy]]'''.
-* Zugunsten der Code Komplexität sollten alle Funktionen, die nicht grundlegend für den betrieb notwenig sind, in externe Module ausgelagert werden. Wenn du dafür extra Schnittstellen oder Events brauchst fühle dich frei welche anzulegen.
+Nicht alle Patches machen es zu OpenSimulator. Um die Code-Komplexität zu reduzieren, versucht OpenSimulator nicht, ein "Batterien eingeschlossenes" Projekt zu sein. Dinge, die nicht als Kernfunktionalität betrachtet werden können, sind besser implementiert als ein Modul für externe Regionen. Wenn zusätzliche Hooks / Events benötigt werden, sind diese Patches sehr willkommen.
-* Halte dich bitte so gut wie möglich an die [[Coding standards|Coding Standards]].
+Bitte überprüfen Sie die [[Coding standards]] und halten Sie sie in Ihrem Patch fest. Die einzige Ausnahme sollte sein, wenn der umgebende Code diesen Richtlinien nicht entspricht. In diesen Fällen ist es in Ordnung, mit dem bereits in der Datei vorhandenen Code übereinzustimmen. Wenn ein Patch den Richtlinien nicht entspricht, werden wir darum bitten, dass es geändert wird.
-* Du kannst Code in form von Patch Files über das [http://opensimulator.org/mantis/my_view_page.php Mantis] System einreichen. <br>Ein weg solche zu erstellen ist über den git Befehl:
+Bitte fügen Sie nur jeweils eine logische Änderung in einem Patch ein. Patches, die mehr als eine logische Änderung enthalten, sind in der Regel größer und komplexer und benötigen daher mehr Zeit für die Anwendung. Im schlimmsten Fall werden Entwickler sie nicht anschauen, da es schwierig ist, alle möglichen Effekte zu entwirren. Mehrere logische Änderungen können sich in einem Patch befinden, wenn sie nur ein einzelnes Feature betreffen (z. B. die Funktion, die der Patch aktiviert).
   git format-patch <commit hash>^!
-Dies wird alle deine Änderungen in eine einzelne Datei verpacken.
+Dies wird alle Ihre git commit-Änderungen in eine schöne, leicht anwendbare Datei packen.
-* Please run the automated tests (via "nant test" on the command line) before submitting your patch. Patches that add new tests (either to test accompanying patch code or to test existing code) are very welcome.
+Sobald du es auf einen Mantis gelegt hast, möchtest du vielleicht auf die IRC-Kanäle springen und dort jemanden erwähnen (obwohl wir im Moment ziemlich gut darin sind, da E-Mails über neu eröffnete Mantis-Einträge sind automatisch an Entwickler gesendet).
-* Please put only one logical change in a patch at a time. Patches that contain more than one logical change tend to be larger, more complex and hence take more time to be applied. At worse, developers will tend not to look at them because it's hard to disentangle all the possible effects.
+Die allgemeine Bearbeitungszeit für den Patch-Review beträgt eine Woche. obwohl es je nach Situation bis zu zwei Wochen dauern kann. Wenn Sie über einen Patch chatten möchten (oder daran erinnern, dass er nach einer Woche existiert), können Sie gerne in # opensim-dev im IRC nachsehen oder eine E-Mail an die openSIM-Entwickler-Liste senden.
-* In your Mantis, the title line should ideally start with [PATCH]. When you've opened it, change the state to patch included. Once you've put in on a Mantis, you may want to hop on the IRC channels and mention it someone there (though at the moment we're pretty good at getting round to these, since e-mails about newly opened mantis entries are sent to developers automatically).
+Wenn ein Patch überprüft wird, wird er entweder angewendet (in diesem Fall vielen Dank!) Oder der Mantis-Eintrag wird in den Status "Patch-Feedback" mit Kommentaren von Entwicklern/Interessenten geändert. Wenn Sie den Patch im Lichte der Diskussion überarbeiten, ändern Sie bitte den Status zurück auf "Patch Included".
-* Once you've submitted your patch please move the Mantis entry into the '''Patch Included''' state to let us know there's a patch waiting to be reviewed.  It might take a bit longer to see a mantis entry with a patch if it's not in this state (and in unfortunate rare cases it may be missed altogether for a period).
+== Aushelfen ==
-* General turnaround time for patch review is a week. though, it could be up to two weeks depending on the situation.  If you want to chat about a patch (or remind people that it exists after a week has gone by), please feel free to pop into #opensim-dev on IRC or send an e-mail to the opensim-dev ailing list.
+Wenn Sie nach einem ersten Code suchen, sind die Bugs in Mantis ein sehr guter Ausgangspunkt. Vielleicht möchten Sie sehen, ob jemand im IRC die Schwierigkeit eines bestimmten Fehlers diskutiert (sie variieren, manchmal auf unerwartete Weise).
-* When a patch is reviewed, it will either be applied (in which case, thanks very much!) or the Mantis entry will be changed to the "Patch feedback" state with comments from developers/interested parties.  If you revise the patch in light of the discussion, please then change the state back to "Patch Included".
+[[Category:Development]]
 [[Category:Development]]

@@ Line 1: / Line 1: @@
 __NOTOC__
-{{Quicklinks|}}
+{{Quicklinks|Submitting_code_to_OpenSim}}
 {{InArbeit|Chris Weymann}}
-* '''Before you begin, please review our [[Contributions Policy]]'''.
+* '''Bevor du anfängst, lese bitte unsere [[Contributions Policy/de|Mitwirkungs-Bedinungen]]'''.
-* Not all patches will make it into OpenSimulator.  To keep a lid on code complexity, OpenSimulator is not trying to be a 'batteries included' project.  Things that can't be considered core functionality are better implements as an external region module.  If extra hooks/events are needed to make these work then patches for those are very welcome.
+* Nicht alle patches schaffen es in OpenSimulator.
-* Please review the [[Coding standards]] and stick to them in your patch. The only exception should be if the surrounding code does not conform to these guidelines, in which cases its okay to be consistent with the code already in the file.  If a patch does not follow the guidelines we will ask for it to be changed.
+* Zugunsten der Code Komplexität sollten alle Funktionen, die nicht grundlegend für den betrieb notwenig sind, in externe Module ausgelagert werden. Wenn du dafür extra Schnittstellen oder Events brauchst fühle dich frei welche anzulegen.
-Code is submitted to OpenSimulator via patches attached to entries in our [http://opensimulator.org/mantis/my_view_page.php Mantis bug tracker]. One way to generate these is by using the Git command line
+* Halte dich bitte so gut wie möglich an die [[Coding standards|Coding Standards]].
   git format-patch <commit hash>^!
-This will package up all your git commit changes into a nice easily appliable file.
+Dies wird alle deine Änderungen in eine einzelne Datei verpacken.
 * Please run the automated tests (via "nant test" on the command line) before submitting your patch. Patches that add new tests (either to test accompanying patch code or to test existing code) are very welcome.