diff --git a/docs/axion1337-fork.md b/docs/axion1337-fork.md index 8aeb48223..8b19f064a 100644 --- a/docs/axion1337-fork.md +++ b/docs/axion1337-fork.md @@ -53,6 +53,73 @@ statt 755 committet (nicht ausführbar); (2) der `matrix-js-sdk#develop`-Git-Ref `pnpm-lock.yaml` war veraltet (fehlte `src/oidc/authorize.ts`, das `apps/web` importiert). Beide behoben. +## 4. Merge-Reibung: was ein Upstream-Update wirklich kostet + +*Arbeitspaket 3 aus ThreadNet-Web#7. Gemessen am 2026-08-06, nicht geschätzt.* + +### Die unangenehme Grundlage zuerst + +**Dieses Repo enthält keine Upstream-Historie.** Element Web 1.12.17 wurde am +2026-05-10 als kompletter Baum importiert — und zwar in `3da3635`, zusammen mit dem +ersten eigenen Feature im selben Commit. Davor liegt nur ein `Initial commit` mit +zwei Dateien. + +Daraus folgt das Wesentliche: **es gibt keinen gemeinsamen Vorfahren mit +`element-hq/element-web`.** Ein `git merge upstream/develop` ist nicht möglich; mit +`--allow-unrelated-histories` erzwungen, kollidiert praktisch jede Datei. Wer „mal +eben Upstream nachziehen" sagt, meint in diesem Repo also: neuen Upstream-Stand +beschaffen und unsere Änderungen darauf neu auftragen. + +Das ist der Grund, warum die Zahl unten überhaupt zählt — sie ist der Aufwand jedes +Updates. + +### Unser Delta: 102 Dateien, davon 12 kritische + +`git diff --name-only 3da3635..main`: + +| Menge | Bereich | Konfliktrisiko | +|---|---|---| +| 46 | CI/Build (`.github/`, `.gitlab-ci.yml`, `dockerbuild/`) | gering — eigene Strecke, Upstreams Workflows brauchen wir nicht | +| 22 | Config, Lockfiles, Upstream-Varianten | mittel — `pnpm-lock.yaml` konfliktet immer, wird aber regeneriert | +| 13 | Web-Assets (`apps/web/res/`) | gering — meist eigene Dateien | +| 4 + 3 | eigene Icons und `apps/desktop/axion1337/` | **keins** — kein Upstream-Pendant | +| **12** | **Upstream-Quellcode** | **hier entsteht die Arbeit** | + +### Die 12 Dateien, und warum sie angefasst wurden + +**Branding (5)** — flach, gut isolierbar: + +- `apps/web/src/SdkConfig.ts` — Defaults für `brand`, `welcome_background_url`, `desktopBuilds` +- `apps/web/src/vector/index.html` — `