From 394b0e69abe3ddef71905e6bfb0519fab560f407 Mon Sep 17 00:00:00 2001
From: viewit <view@it-drui.de>
Date: Wed, 24 Jun 2026 13:32:47 +0200
Subject: [PATCH] =?UTF-8?q?docs:=20CONTRIBUTING.md=20hinzuf=C3=BCgen=20(Fo?=
 =?UTF-8?q?rk-Flow,=20Branch-Modell,=20Commit-Stil)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 CONTRIBUTING.md | 102 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 102 insertions(+)
 create mode 100644 CONTRIBUTING.md

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 0000000..1b5eb74
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,102 @@
+# Contributing to KX-Bridge
+
+Thanks for taking the time to contribute! Here's everything you need to know.
+
+---
+
+## How to report a bug or request a feature
+
+Use the issue tracker:
+
+- **Bug:** [New Bug Report](https://gitea.it-drui.de/viewit/KX-Bridge-Release/issues/new?template=bug_report.md)
+- **Feature:** [New Feature Request](https://gitea.it-drui.de/viewit/KX-Bridge-Release/issues/new?template=feature_request.md)
+
+Please fill in the template — especially the **KX-Bridge version** and **logs**.  
+Issues without version info are hard to debug.
+
+---
+
+## How to submit a Pull Request
+
+### 1. Fork the repository
+
+Click **Fork** at the top of this page.  
+You now have your own copy at `gitea.it-drui.de/your-username/KX-Bridge-Release`.
+
+### 2. Clone your fork
+
+```bash
+git clone https://gitea.it-drui.de/your-username/KX-Bridge-Release.git
+cd KX-Bridge-Release
+```
+
+### 3. Create a branch
+
+Always branch off `nightly`:
+
+```bash
+git checkout nightly
+git checkout -b feature/my-feature   # or fix/my-fix
+```
+
+### 4. Make your changes
+
+- Test your changes locally with Docker:
+  ```bash
+  docker build -t kx-bridge:dev .
+  docker run -p 7125:7125 -v ./config:/app/config kx-bridge:dev
+  ```
+- No debug `print()` statements — use `logging`
+- Keep commits focused; one thing per commit
+
+### 5. Push and open a PR
+
+```bash
+git push origin feature/my-feature
+```
+
+Gitea will show a banner — click **"Create Pull Request"**.  
+The PR template will be pre-filled. Set the target branch to **`nightly`**.
+
+---
+
+## Branch model
+
+```
+main      ← stable releases only (merged by maintainer)
+nightly   ← integration branch — PRs go here
+feature/* ← your feature branch (in your fork)
+fix/*     ← your bugfix branch (in your fork)
+```
+
+Your PR always targets `nightly`. The maintainer periodically merges `nightly → main` for a new stable release.
+
+---
+
+## Commit style
+
+Use conventional commit prefixes:
+
+| Prefix | When |
+|---|---|
+| `feat:` | new feature |
+| `fix:` | bug fix |
+| `docs:` | documentation only |
+| `chore:` | maintenance, dependencies |
+| `refactor:` | code change without new feature or fix |
+
+Example: `fix: prevent crash when printer is offline during startup`
+
+---
+
+## Language
+
+- **Code and comments:** English
+- **Issue comments:** match the language of the issue (if someone writes in German, reply in German)
+- **Commit messages:** English
+
+---
+
+## Questions?
+
+Open a [Discussion](https://gitea.it-drui.de/viewit/KX-Bridge-Release/issues) or leave a comment on the relevant issue.