docs: document the merged tariff feature (#1024)

Author: JohannesRudolph

docs/tariffs.mdx

@@ -242,6 +242,40 @@ tariffs:
 
 In diesem Beispiel gibt es eine fixe Einspeisevergütung von 7 ct/kWh, außer bei negativen Börsenpreisen.
 
+### Mehrere Tarifquellen kombinieren {#merged}
+
+Die `merged`-Tariffart ermöglicht es, zwei Tarifquellen zu kombinieren, um längere Vorhersagehorizonte zu nutzen.
+Dies ist besonders nützlich, wenn du Echtpreise von einer primären Quelle mit Prognosen von einer sekundären Quelle verbinden möchtest.
+
+Die **primäre Quelle** sollte aktuelle und genaue Preise liefern (z. B. realisierte Börsenpreise), während die **sekundäre Quelle** Vorhersagen für Zeiträume bereitstellt, die von der primären Quelle nicht abgedeckt werden.
+
+```yaml
+tariffs:
+  grid:
+    type: merged
+    primary:
+      type: template
+      template: energy-charts-api
+      bzn: DE-LU # Gebotszone
+      charges: 0.22 # Aufschlag (EUR/kWh)
+      tax: 0.19 # MwSt. (%)
+    secondary:
+      type: template
+      template: epex-predictor
+      region: DE
+      charges: 0.22 # Aufschlag (EUR/kWh)
+      tax: 0.19 # MwSt. (%)
+```
+
+evcc kombiniert die Daten automatisch:
+Die Preise der primären Quelle werden verwendet, soweit verfügbar.
+Danach folgen die Prognosen der sekundären Quelle für zukünftige Zeiträume.
+
+:::info
+Beide Tarifquellen müssen kompatible Typen sein.
+Beispielsweise können zwei Börsenpreis-Quellen, zwei Preis-APIs oder ein auf aktuellen Preisen basierendes Template mit einer Prognose-Quelle kombiniert werden.
+:::
+
 <!-- AUTO-GENERATED CONTENT BELOW THIS LINE -->
 
 <!-- AUTO-GENERATED FROM TEMPLATE - PLEASE EDIT HERE https://github.com/evcc-io/evcc/tree/master/templates/definition/tariff  -->

i18n/en/docusaurus-plugin-content-docs/current/tariffs.mdx

@@ -243,6 +243,40 @@ tariffs:
 
 In this example, there is a fixed feed-in tariff of 7 ct/kWh, except in the case of negative day-ahead market prices.
 
+### Combining Multiple Tariff Sources {#merged}
+
+The `merged` tariff type allows you to combine two tariff sources to leverage longer forecast horizons.
+This is especially useful when you want to combine real prices from a primary source with forecasts from a secondary source.
+
+The **primary source** should provide current and accurate prices (e.g., realized market prices), while the **secondary source** provides forecasts for time periods that the primary source does not cover.
+
+```yaml
+tariffs:
+  grid:
+    type: merged
+    primary:
+      type: template
+      template: energy-charts-api
+      bzn: DE-LU # Bidding zone
+      charges: 0.22 # Surcharge (EUR/kWh)
+      tax: 0.19 # VAT (%)
+    secondary:
+      type: template
+      template: epex-predictor
+      region: DE
+      charges: 0.22 # Surcharge (EUR/kWh)
+      tax: 0.19 # VAT (%)
+```
+
+evcc combines the data automatically:
+prices from the primary source are used as long as available.
+This is followed by forecasts from the secondary source for future time periods.
+
+:::info
+Both tariff sources must be of compatible types.
+For example, you can combine two exchange price sources, two price APIs, or a template based on current prices with a forecast source.
+:::
+
 <!-- AUTO-GENERATED CONTENT BELOW THIS LINE -->
 
 <!-- AUTO-GENERATED FROM TEMPLATE - PLEASE EDIT HERE https://github.com/evcc-io/evcc/tree/master/templates/definition/tariff  -->