Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
de:entwickler:fehlerkorrekturen_in_mehreren_versionen [2015/10/09 10:46]
fasse commits comments
de:entwickler:fehlerkorrekturen_in_mehreren_versionen [2015/10/12 10:43] (current)
fasse Korrekturen
Line 5: Line 5:
 Wir entwickeln Admidio mit Hilfe der Versionsverwaltung [[http://​de.wikipedia.org/​wiki/​Git|Git]] auf der Plattform [[http://​www.github.com|GitHub]]. Der aktuelle Sourcecode befindet sich im sogenannten **Master** Branch und ist über folgenden Link zu finden: Wir entwickeln Admidio mit Hilfe der Versionsverwaltung [[http://​de.wikipedia.org/​wiki/​Git|Git]] auf der Plattform [[http://​www.github.com|GitHub]]. Der aktuelle Sourcecode befindet sich im sogenannten **Master** Branch und ist über folgenden Link zu finden:
   https://​github.com/​Admidio/​admidio   https://​github.com/​Admidio/​admidio
-GitHub bietet außerdem einen Client für [[https://​mac.github.com/​Mac|Mac]] und [[https://​windows.github.com/​|Windows]] an.+GitHub bietet außerdem einen Client für [[https://​mac.github.com/​Mac|Mac]] und [[https://​windows.github.com/​|Windows]] an. Weitere Git Programme gibt es unter [[https://​git-scm.com/​]].
  
 Bevor du mit der Entwicklung neuer Funktionen anfängst, solltest du Kontakt mit uns aufnehmen bzw. [[https://​help.github.com/​articles/​about-issues/​|Issue-Tracker]] nutzen um dort die gewünschte Erweiterung zu beschreiben bzw. Ideen für neue Funktionen zu sammeln. Bevor du mit der Entwicklung neuer Funktionen anfängst, solltest du Kontakt mit uns aufnehmen bzw. [[https://​help.github.com/​articles/​about-issues/​|Issue-Tracker]] nutzen um dort die gewünschte Erweiterung zu beschreiben bzw. Ideen für neue Funktionen zu sammeln.
  
-Hast du deine Idee als [[https://​help.github.com/​articles/​about-issues/​|Issue]] formuliert und mit uns abgestimmt, dann findest du im **Master** Branch den Code der letzten stabilen Version ​und zusätzlich alle stabilen Erweiterungen, die seit dem letzten Release hinzugekommen sind. Falls du Admidio weiterentwickeln willst, empfehlen wir dir diesen Branch als Basis zu nehmen. Idealerweise erstellst du dann von diesem Branch ​in deinem GitHub Account einen [[https://​guides.github.com/​activities/​forking/#​fork|Fork]]. Dort kannst du nun deine Erweiterung entwickeln und in den Fork [[https://​guides.github.com/​activities/​forking/#​making-changes|commiten]]. Sobald deine Erweiterung fertig ist, kannst du einen [[https://​guides.github.com/​activities/​forking/#​making-a-pull-request|Pull Request]] für unseren **Master** Branch erstellen. Diesen werden wir uns dann anschauen und besprechen um ihn dann im Idealfall zu übernehmen.+Hast du deine Idee als [[https://​help.github.com/​articles/​about-issues/​|Issue]] formuliert und mit uns abgestimmt, dann findest du im **Master** Branch den aktuellen ​Code mit allen neuen Funktionen ​und Änderungen, die seit dem letzten Release hinzugekommen sind. Falls du Admidio weiterentwickeln willst, empfehlen wir dir diesen Branch als Basis zu nehmen. Idealerweise erstellst du dann in deinem GitHub Account einen [[https://​guides.github.com/​activities/​forking/#​fork|Fork]] ​und von diesem Branch einen Feature-Branch. Dort kannst du nun deine Erweiterung entwickeln und in den Fork [[https://​guides.github.com/​activities/​forking/#​making-changes|commiten]]. Sobald deine Erweiterung fertig ist, kannst du einen [[https://​guides.github.com/​activities/​forking/#​making-a-pull-request|Pull Request]] für unseren **Master** Branch erstellen. Diesen werden wir uns dann anschauen und besprechen um ihn dann im Idealfall zu übernehmen.
  
 Kurz nachdem wir eine neue Hauptversion veröffentlicht haben, erstellen wir einen sogenannten Branch speziell zu dieser Version. Hier wird praktisch der aktuelle Entwicklungsstand passend zur veröffentlichten Version festgehalten. Auf diesem Entwicklungsstand können wir dann später Korrekturen einspielen unabhängig davon, was parallel im **Master** weiter entwickelt wurde. Der Branch ist bei uns immer passend zu einer Version. Am Namen des Branches kann man erkennen, welche Version hinter welchem Branch steckt. Beispiel für Admidio 2.4 ist der Branchname **v2.4** den du unter folgender URL erreichst: Kurz nachdem wir eine neue Hauptversion veröffentlicht haben, erstellen wir einen sogenannten Branch speziell zu dieser Version. Hier wird praktisch der aktuelle Entwicklungsstand passend zur veröffentlichten Version festgehalten. Auf diesem Entwicklungsstand können wir dann später Korrekturen einspielen unabhängig davon, was parallel im **Master** weiter entwickelt wurde. Der Branch ist bei uns immer passend zu einer Version. Am Namen des Branches kann man erkennen, welche Version hinter welchem Branch steckt. Beispiel für Admidio 2.4 ist der Branchname **v2.4** den du unter folgender URL erreichst:
Line 24: Line 24:
  
   - Beschreibe auf unserer GitHub-Projektseite deine geplante Erweiterung. Dazu erfasst du einen neuen [[https://​github.com/​Admidio/​admidio/​issues|Issue]] und gibst diesem das Label **Enhancement**. Über diesen Issue und die dort beschriebene Funktion haben andere Teammitglieder oder Interessierte die Möglichkeit deine gewünschte Änderung kennenlernen und ggf. Anmerkungen dazu zu schreiben.   - Beschreibe auf unserer GitHub-Projektseite deine geplante Erweiterung. Dazu erfasst du einen neuen [[https://​github.com/​Admidio/​admidio/​issues|Issue]] und gibst diesem das Label **Enhancement**. Über diesen Issue und die dort beschriebene Funktion haben andere Teammitglieder oder Interessierte die Möglichkeit deine gewünschte Änderung kennenlernen und ggf. Anmerkungen dazu zu schreiben.
-  - Möchtest du nun die Funktion ​codieren, dann wechsel ​zum **master** Branch und erzeuge einen [[https://​help.github.com/​desktop/​guides/​contributing/​creating-a-branch-for-your-work/​|neuen Branch]]. Dieser bekommt als Namen das Präfix **feature-** und einen kurzen Funktionsnamen z.B. //​feature-bootstrap3-integration//​ oder //​feature-improved-registration//​ Dieser soll dann zukünftig nur deine Änderungen enthalten. Hast du noch keine Schreibrecht im Admidio-Repository dann kannst du die Funktion auch in deinem Fork entwickeln. +  - Möchtest du nun die Funktion ​programmieren, dann wechsle ​zum **master** Branch und erzeuge einen [[https://​help.github.com/​desktop/​guides/​contributing/​creating-a-branch-for-your-work/​|neuen Branch]]. Dieser bekommt als Namen das Präfix **feature-** und einen kurzen Funktionsnamen z.B. //​feature-bootstrap3-integration//​ oder //​feature-improved-registration//​ Dieser soll dann zukünftig nur deine Änderungen enthalten. Hast du noch keine Schreibrecht im Admidio-Repository dann kannst du die Funktion auch in deinem Fork entwickeln. 
-  - Nun kannst du deine Änderungen in diesem Branch (Fork) entwickeln und committen, bis diese aus deiner Sicht fertig ist. Beim Einchecken (commit) sollte ein beschreibeneder ​Satz vorzugsweise in Englisch angegeben werden. +  - Nun kannst du deine Änderungen in diesem ​Feature-Branch (oder deinem eigenen ​Fork) entwickeln und committen, bis diese aus deiner Sicht fertig ist. Beim Einchecken (commit) sollte ein beschreibender ​Satz vorzugsweise in Englisch angegeben werden. 
-  - Erstelle nun aus deinem Branch (Fork) einen [[https://​help.github.com/​desktop/​guides/​contributing/​sending-a-pull-request/​|Pull-Request]]. Diesen kann nun ein anderer Entwickler prüfen und //mergen//.+  - Erstelle nun aus deinem ​Feature-Branch (oder deinem eigenen ​Fork) einen [[https://​help.github.com/​desktop/​guides/​contributing/​sending-a-pull-request/​|Pull-Request]]. Diesen kann nun ein anderer Entwickler prüfen und //mergen//.
  
 ===== Wie und wo behebe ich einen Fehler ? ===== ===== Wie und wo behebe ich einen Fehler ? =====
Line 33: Line 33:
   - Im ersten Schritt muss, wie bei neuen Funktionen auch, ein [[https://​github.com/​Admidio/​admidio/​issues|Issue]] erfasst werden, falls dieser nicht bereits schon existiert.   - Im ersten Schritt muss, wie bei neuen Funktionen auch, ein [[https://​github.com/​Admidio/​admidio/​issues|Issue]] erfasst werden, falls dieser nicht bereits schon existiert.
   - Ist der Fehler in der zuletzt veröffentlichten Version vorhanden, so sollte er dort auch korrigiert werden. Dazu wechselst du zu dem entsprechenden Branch z.B. **v3.0**.   - Ist der Fehler in der zuletzt veröffentlichten Version vorhanden, so sollte er dort auch korrigiert werden. Dazu wechselst du zu dem entsprechenden Branch z.B. **v3.0**.
-  - Behebe den Fehler und führe die entsprechenden Commits in dem Branch durch. Beim Einchecken (commit) sollte ein beschreibeneder ​Satz vorzugsweise in Englisch angegeben werden, der außerdem einen Verweis zum betreffenden Issue hat z.B. //#4711 fix sql syntax when save new events//+  - Behebe den Fehler und führe die entsprechenden Commits in diesem ​Branch durch. Beim Einchecken (commit) sollte ein beschreibender ​Satz vorzugsweise in Englisch angegeben werden, der außerdem einen Verweis zum betreffenden Issue hat z.B. //#4711 fix sql syntax when save new events//
   - I.d.R. tritt der Fehler auch im **master** Branch auf, so dass die Commits über einen [[https://​help.github.com/​articles/​merging-branches/​|Merge]] in den **master** Branch übernommen werden müssen. Dieser Schritt kann aber auch später erfolgen.   - I.d.R. tritt der Fehler auch im **master** Branch auf, so dass die Commits über einen [[https://​help.github.com/​articles/​merging-branches/​|Merge]] in den **master** Branch übernommen werden müssen. Dieser Schritt kann aber auch später erfolgen.
  
 Habt ihr noch keine Schreibrechte im Admidio-Projekt auf GitHub, so könnt ihr das Repository erst einmal [[https://​help.github.com/​articles/​fork-a-repo/​|forken]] und dort die Korrektur vornehmen. Anschließend kann die Korrektur dann über einen [[https://​help.github.com/​articles/​creating-a-pull-request/​|Pull Request]] in den offiziellen Code übernommen werden. Habt ihr noch keine Schreibrechte im Admidio-Projekt auf GitHub, so könnt ihr das Repository erst einmal [[https://​help.github.com/​articles/​fork-a-repo/​|forken]] und dort die Korrektur vornehmen. Anschließend kann die Korrektur dann über einen [[https://​help.github.com/​articles/​creating-a-pull-request/​|Pull Request]] in den offiziellen Code übernommen werden.
  • de/entwickler/fehlerkorrekturen_in_mehreren_versionen.txt
  • Last modified: 2015/10/12 10:43
  • by fasse