From f22abb84e3d739e9201dd179fc77cfa175bf7698 Mon Sep 17 00:00:00 2001
From: dgodglue <dennisgodglueck@hotmail.de>
Date: Mon, 17 Nov 2025 21:01:55 +0100
Subject: [PATCH 1/3] docs: added two more commands, git clone and git add
 <file>

---
 README.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index e37ee3e..c99d75e 100644
--- a/README.md
+++ b/README.md
@@ -14,11 +14,13 @@ Dieses Repository dient dazu, sich mit Git-Befehlen und GitHub-Features vertraut
 ## 🚀 Nützliche Git-Befehle
 
 ```bash
+git clone               # Repository klonen
 git status              # Aktueller Status
 git add .               # Alle Änderungen hinzufügen
+git add <file>          # Spezifische Änderungen hinzufügen
 git commit -m "Message" # Commit erstellen
+git pull                # Änderungen holen und (default) HEAD mergen
 git push                # Zum Remote-Repository pushen
-git pull                # Änderungen holen
 ```
 
 ## 🥳 Git Online Browser Game

From 45ba62bd6d215814b07fe722eead87057bbd6df9 Mon Sep 17 00:00:00 2001
From: dgodglue <dennisgodglueck@hotmail.de>
Date: Mon, 17 Nov 2025 21:14:13 +0100
Subject: [PATCH 2/3] chore: using php style konfiguration for cs-fixer

---
 .php-cs-fixer.dist.php | 32 ++++++++++++++++++++++
 phpcs.xml.dist         | 62 ------------------------------------------
 2 files changed, 32 insertions(+), 62 deletions(-)
 create mode 100644 .php-cs-fixer.dist.php
 delete mode 100644 phpcs.xml.dist

diff --git a/.php-cs-fixer.dist.php b/.php-cs-fixer.dist.php
new file mode 100644
index 0000000..60a344e
--- /dev/null
+++ b/.php-cs-fixer.dist.php
@@ -0,0 +1,32 @@
+<?php
+
+$finder = (new PhpCsFixer\Finder())
+    ->in(__DIR__)
+    ->exclude('includes/external')
+;
+
+return (new PhpCsFixer\Config())
+    ->setRules([
+        '@PSR12' => true,
+        '@PHP82Migration' => true,
+        'header_comment' => false,
+        'single_class_element_per_statement' => false,
+        'no_leading_import_slash' => false,
+        'declare_strict_types' => false,
+        'return_type_declaration' => [
+            'space_before' => 'none',
+        ],
+        'declare_equal_normalize' => false,
+        'lowercase_cast' => false,
+        'lowercase_keywords' => true,
+        'blank_line_between_import_groups' => false,
+        'compact_nullable_type_declaration' => false,
+        'ordered_class_elements' => false,
+        'ordered_imports' => false,
+        
+        'visibility_required' => [
+             'elements' => ['property', 'method'], 
+        ],
+    ])
+    ->setFinder($finder)
+;
\ No newline at end of file
diff --git a/phpcs.xml.dist b/phpcs.xml.dist
deleted file mode 100644
index 8493cef..0000000
--- a/phpcs.xml.dist
+++ /dev/null
@@ -1,62 +0,0 @@
-<?xml version="1.0"?>
-<ruleset name="Project PSR-12 Style Only">
-    <description>
-        PSR-12 als Basis, aber alle „logiknahen“ Regeln (Namespaces, Side Effects,
-        Strict Types, Typ-Decls etc.) sind deaktiviert. Es bleiben vor allem
-        Whitespace- und Formatierungsregeln übrig.
-    </description>
-
-    <!-- Was nie geprüft werden soll -->
-    <exclude-pattern>includes/external/*</exclude-pattern>
-
-    <!-- Basis: kompletter PSR-12 Standard -->
-    <rule ref="PSR12"/>
-
-    <!-- =========
-         LOGIK-/STRUKTUR-REGELN DEAKTIVIEREN
-         ========= -->
-
-    <!-- Side Effects & "1 Klasse pro Datei + Namespace" -->
-    <rule ref="PSR1.Files.SideEffects">
-        <severity>0</severity>
-    </rule>
-
-    <rule ref="PSR1.Classes.ClassDeclaration">
-        <severity>0</severity>
-    </rule>
-
-    <!-- declare(strict_types=1) & Co. -->
-    <rule ref="PSR12.Files.DeclareStatement">
-        <severity>0</severity>
-    </rule>
-
-    <!-- Typed Parameter & Return Types -->
-    <rule ref="PSR12.Functions.NullableTypeDeclaration">
-        <severity>0</severity>
-    </rule>
-
-    <rule ref="PSR12.Functions.ReturnTypeDeclaration">
-        <severity>0</severity>
-    </rule>
-
-    <!-- Kurzformen von Typkeywords (bool/int/...) -->
-    <rule ref="PSR12.Keywords.ShortFormTypeKeywords">
-        <severity>0</severity>
-    </rule>
-
-    <!-- Namespace-Struktur -->
-    <rule ref="PSR12.Namespaces.CompoundNamespaceDepth">
-        <severity>0</severity>
-    </rule>
-
-    <!-- Sichtbarkeit von Konstanten erzwingen (kann Backward Compatibility sein) -->
-    <rule ref="PSR12.Properties.ConstantVisibility">
-        <severity>0</severity>
-    </rule>
-
-    <!-- Optional: Wenn du noch mehr "Logik-Nähe" rauswerfen willst,
-         kannst du hier weitere Sniffs nach Bedarf auf severity=0 setzen. -->
-
-    <!-- Nur Infos: Warnungen kannst du komplett ausblenden, wenn du magst -->
-    <!-- <arg name="warning-severity" value="0"/> -->
-</ruleset>
\ No newline at end of file

From ce4cb170b6ad2b19dcea800c6a16fecd0f130433 Mon Sep 17 00:00:00 2001
From: dgodglue <dennisgodglueck@hotmail.de>
Date: Mon, 17 Nov 2025 22:23:58 +0100
Subject: [PATCH 3/3] docs: extends docs with best practices

---
 README.md | 40 +++++++++++++++++++++++++++++++++-------
 1 file changed, 33 insertions(+), 7 deletions(-)

diff --git a/README.md b/README.md
index c99d75e..cd0cca7 100644
--- a/README.md
+++ b/README.md
@@ -14,15 +14,41 @@ Dieses Repository dient dazu, sich mit Git-Befehlen und GitHub-Features vertraut
 ## 🚀 Nützliche Git-Befehle
 
 ```bash
-git clone               # Repository klonen
-git status              # Aktueller Status
-git add .               # Alle Änderungen hinzufügen
-git add <file>          # Spezifische Änderungen hinzufügen
-git commit -m "Message" # Commit erstellen
-git pull                # Änderungen holen und (default) HEAD mergen
-git push                # Zum Remote-Repository pushen
+git clone                   # Repository klonen
+git checkout -b <branch>    # Erstellen eines Zweig-Branches aus dem aktuell ausgecheckten Branch
+git status                  # Aktueller Status
+git add .                   # Alle Änderungen hinzufügen
+git add <file>              # Spezifische Änderungen hinzufügen
+git commit -m "Message"     # Commit erstellen
+git pull                    # Änderungen holen und (default) HEAD mergen
+git push                    # Zum Remote-Repository pushen
 ```
 
+## ✅ Best Practices
+Um die Zusammenarbeit im Team zu optimieren, ist die Anwendung sogenannter Best Practices unerlässlich.
+Deren konsequente Einhaltung steigert erheblich die Nachvollziehbarkeit der Änderungen, sowie die Wartbarkeit 
+und dadurch maßgeblich die Qualität der Software. Folgende Empfehlungen haben sich etabliert:
+
+- Tickernummern müssen im Branch-Namen erkenntlich sein
+  -    origin/3050_main
+- Änderungen sollten in kleineren Commits dokumentiert werden
+  - einheitliche und englischsprachige Commit-Nachrichten verwenden
+  - Ticketnummer in eckigen Klammern und kurzer Titel des Tickets
+  - Präfixe wie z.B. fix, feat, docs, usw. verwenden
+  - Der Betreff sollte mit einem Großbuchstaben beginnen
+- regelmäßiges Synchronisieren des Forkes um Merge-Konflikte zu minimieren
+### Example commit-msg:
+```
+# [3050] Betreffzeile (max. 50 Zeichen)
+#
+# Längere Beschreibung mit 72 Zeichen pro Zeile (wrapped)
+# Kurz erklären warum die Änderungen gemacht wurden
+# und welche Auswirkungen diese haben
+#
+# Link zum Ticket kann hier optional eingefügt werden
+```
+
+
 ## 🥳 Git Online Browser Game
 Wer ein paar Git Grundlagen lernen oder auffrischen möchte, für den ist folgendes
 Browser Online Game etwas. In diesem Spiel kann man Git in kleinen Schritten spielerisch lernen.