AutoIt Community (GitHub Organization)

**SOLVE-SMART**

Teil 3, der kleinen Git/GitHub workflow Reihe ist nun auch fertig dokumentiert.

Wie arbeite ich auf GitHub (Fork + Pull Request) (oder wie contribute ich auf GitHub)

Mir fällt sicherlich noch mehr ein, doch damit kann man schon das Meiste auf GitHub umsetzen was man üblicherweise braucht.

Viele Grüße
Sven

argumentum

Zunächst einmal bin ich von Natur aus unorganisiert (ein genetisches Problem)
Ehrlich gesagt, werde ich einfach ein „Spieleprojekt“ starten und es ausprobieren.
Sobald ich etwas Erfahrung gesammelt habe, werde ich bessere Fragen stellen können und auch die Antworten finden

**SOLVE-SMART**

Hi zusammen ✌️ ,

die Nutzerführung und Unterstützung beim "contributen", also beim erstellen von "Issues" oder "Pull requests" ist nun noch besser. Denn ich habe "community standard files" integriert. Was das ist? Damit sind Issues nicht mehr einfach nur Freitext Felder sondern Formulare in denen alle wichtigen Informationen abgefragt werden. Man kann also weniger vergessen.

Ein Beispiel ist, wenn ihr auf den "New issue" button (des Projektes "files-au3") geht und dann entweder "Bug report" oder eine andere Kategorie auswählt.

Ich plane dies in alle Repositories, auch die von euch oder aus dem englischen Forum, kommenden (neuen) zu etablieren.

#konsistenz
#standards

Das wäre es für heute ✌️ .

Viele Grüße
Sven

**SOLVE-SMART**

Guten Morgen zusammen ✌️ ,

es bahnt sich ein weiteres interessantes Projekt (Repository) in der GitHub Org. "AutoIt-Community" an.
Dies nur als Teaser, mal sehen wann - ich werde euch berichten 😅 .

Einen guten Start in den Tag allen.

Viele Grüße
Sven

**Schnuffel**

Hallo Sven,
ich hab mich grad mal in Git connected.
Ich stoße auf folgenden Fehler, wenn ich die Example.au3 editieren und pushen will:

**SOLVE-SMART**

Hi Schnuffel ✌️ , schön von dir zu hören bzw. lesen.

Ja der "main" branch (default branch) ist protected - da kannst du nicht ohne einen Pull Request anzulegen drauf schreiben.
Versuche dich mal bitte durch diese Anleitung zu wühlen, denn da beschreibe ich wie du mit forks und pull requests umgehst.

Der einfache Weg, dass man in sein eigenes Repository auf den default branch einfach schreiben kann, geht natürlich wenn man für sich selbst keine branch policies angelegt hat. Da dies aber in der Open Source Welt (nicht nur auf GitHub) unüblich ist (außer es sind Privatprojekte wo sowieso kein anderer mitwirkt), habe ich die Einstellungen so praxisnah wie möglich gesetzt.

Also kurz: du musst einen pull request stellen, damit du die Example.au3 editieren kannst!
Umständlich ==> ja, praxisnah ==> ja, Gewohnheitssache ==> ja 😅 .

Viele Grüße
Sven

**chesstiger**

Hi,

ich hab zwar mit der konkreten Organisation nichts zutun, aber ich kann dir da allgemein helfen.

In größeren Projekten und Communities wird üblicherweise nicht direkt auf dem jeweiligen Upstream-Repository gearbeitet, weil das relativ schwer zu maintainen ist. Man spricht an der Stelle von sogenannten Git Workflows, d.h. die Funktionen von Git werden auf eine bestimmte Weise zur Zusammenarbeit genutzt. Soweit mir bekannt, ist der üblicherweise auf GitHub verwendete Workflow der Fork Workflow. Das heißt:

Du erstellst einen persönlichen Fork vom Upstream-Repository auf deinem GitHub-Account
Du erstellst in deinem Fork einen entsprechenden Feature Branch
Du commitest deine Änderungen auf diesen Branch und pushst die Änderungen auf dein persönliches Repo
Du erstellst einen Pull Request im Upstream-Repository, der sich auf dein persönliches Repo bezieht
Ein Maintainer mit entsprechenden Rechten kann diesen Pull Request dann akzeptieren, dann werden die Änderungen in den jeweiligen Branch vom Upstream-Repo eingepflegt (dieser Schritt geht komplett über die GitHub Web-UI)
(Den letzten Schritt kann man - um die Übersichtlichkeit zu wahren - mit einem Squash kombinieren. Damit kann man all deine Commits auf deinem Fork in einen einzelnen Commit im Upstream-Repo zusammenpressen, was die Commit-History klar und übersichtlich hält.)

Um diesen Workflow zu erzwingen, wird dann üblicherweise der Master-Branch im Upstream-Repository für direkte Schreibänderungen gesperrt (siehe deine Fehlermeldung: "Protected Branch - Changes must be made through a Pull Request".

**SOLVE-SMART**

Vielen Dank chesstiger , dem gibt es nichts hinzuzufügen 🤝 .
Ich hatte es versucht hier (de) und hier (en) zusammenzufassen, doch deine Erklärung hilft sehr - Danke.

Viele Grüße
Sven

----------------

Btw.: Magst du der AutoIt-Community auf GitHub beitreten? Dann schicke ich 'ne invitation raus, falls du mir deine Accountnamen verrätst. Falls du keinen Bedarf hast, auch nicht schlimm, nur schade 😅 .

**Schnuffel**

okay, danke für die ausführliche Anleitung.

Ich habe bisher nur andere von meinem Zeug partizipieren lassen ohne Schreibrechte.
Daher bin ich bisher nicht auf solche Probleme gestossen.

Wenn man kurz darüber nachdenkt ist es ja auch absolut logisch,
dass nicht jeder Contributor einfach so den main Branch editieren kann.

**SOLVE-SMART**

An alle Interessierte: Schnuffel hat den Workflow geschafft und kollaborativ auf GitHub gearbeitet 😁 (Code einer Datei erweitert).
Ich erwähne dies nicht weil ich ihm das nicht zugetraut hätte, ganz im Gegenteil, nein weil es wirklich nicht schwierig ist sondern "nur" gewöhnungsbedürftig.

Also wer mit sich ggf. noch hardert, versuch' es einfach 😅 .
Natürlich ist nicht der "playground" nicht so attraktiv wie das eigene Projekt, doch ein Anfang.

Viele Grüße und einen guten Abend euch,
Sven

**SOLVE-SMART**

Hi Leute 👋,

kleines Update:

Die GitHub-Organisation wächst langsam. Aktive Arbeit findet derzeit für das Repository files-au3 statt.
Neue Repositories sind in Vorbereitung. Zwei davon beziehen sich auf UDFs, eines könnte ein konkretes neues Projekt/Software werden.
Mögliche Mitwirkende tauchen langsam in der Organisation auf. Dann könnte noch mehr passieren.

Ich versuche, die Leute über Foren threads (englisches und deutsches Forum) und über den Discord-Server zu informieren, muss mich aber auch um meine Familie und meine Arbeit kümmern.
Erwartet also nicht, dass sehr viel sehr schnell passiert.

==> Ich bin fest davon überzeugt, dass kontinuierlicher Fortschritt in Zusammenarbeit, Projekte und Spaß münden wird.

Das ist erstmal alles.

Viele Grüße
Sven

argumentum

Ich werde die benutzerdefinierte Funktion MsgBox_Extn() im GitHub-Stil kopieren, um etwas hinzuzufügen und dabei etwas darüber zu lernen. Es ist aber nichts, was unbedingt erweitert werden müsste.
Ist das eine gute Idee? 🤔

**SOLVE-SMART**

Hi argumentum , ich bin mir unsicher was du meinst mit "im GitHub-Stil kopieren".
Wo möchtest du es ablegen, die UDF? In einem neuen Repository oder im playground oder wie?

Egal wie, du machst nichts falsch - probiere es einfach. Die UDF wo anders hinlegen können wir bei Bedarf im Nachgang auch noch, also Danke und auf geht's.

Viele Grüße
Sven

PS.: Es ist komisch mit dir in deutsch zu schreiben 😅 .

argumentum

Zitat von SOLVE-SMART

PS.: Es ist komisch mit dir in deutsch zu schreiben 😅 .

Das ist für mich auch seltsam. 😅

Ich dachte mir, dass vieles von dem, was ich programmiert habe, unbekannt ist und GitHub Inhalte braucht, also wollte ich es auch auf GitHub veröffentlichen.
Leider habe ich gerade heute viel Arbeit bekommen und werde diese Woche keine Zeit haben, es zu erledigen, wie ich es geplant hatte. 😓

Wohin soll das gehen? Zu meinem eigenen GitHub oder zu dem, den Sie für uns alle erstellt haben?.

**SOLVE-SMART**

Hi argumentum 👋 ,

Danke!
Mache dir keinen Stress, es kommt nicht auf die Woche an. Nur die Ruhe.
Vielleicht erstellst du erstmal ein eigenes Repository bei dir, also unter deinem Account und dann tranferieren wir das Repo dann in die GitHub Organisation "AutoIt-Community". Das geht recht einfach und ist schnell gemacht.

Warum ist dies meine Empfehlung? Denn sobald in der Organisation ein Repo angelegt wird, erstelle ich branch policies (protection rules) und pflege "GitHub Community Standard documents" ein. Also pull request templates, issue templates, contribution guideline usw. Das können wir uns erstmal sparen, wenn du den Code und die Inhalte die ins Repository sollen bei dir anlegst und wir dann den Umzug machen.

Gern kannst du auch deine Tools, UDFs oder was es auch noch sein wird, aufteilen und nicht alles in ein Repo ablegen. Dies ist sinnvoll wenn sich die Dinge thematisch auch unterscheiden. Doch das überlasse ich dir am Ende. Wenn du jedoch bei Entscheidungen unsicher sein solltest, frage gerne nach. Ich gebe gern Empfehlungen, möchte aber nicht zu aufdringlich sein und zu viele "harte Vorgaben" machen 😅 .

Nochmal zu 1.: Danke 🤝 .

Viele Grüße
Sven