improve ics documentation

doc/source/ics.md

@@ -6,22 +6,24 @@ This source has been successfully tested with the following service providers:
 
 ### Germany
 - [Abfall Landkreis Stade](https://abfall.landkreis-stade.de/)
-- [AVL Ludwigsburg](https://www.avl-ludwigsburg.de/)
+- [Abfallkalender Zollernalbkreis](https://www.zollernalbkreis.de/landratsamt/aemter++und+organisation/Elektronischer+Abfallkalender) ([Example](#abfallkalender-zollernalbkreis))
+- [Abfallwirtschaft Kreis Böblingen](https://www.lrabb.de/start/Service+_+Verwaltung/Abfuhrtermine.html)
+- [AVL Ludwigsburg](https://www.avl-ludwigsburg.de/) ([Example](#avl-ludwigsburg))
+- [ASR Chemnitz](https://www.asr-chemnitz.de/kundenportal/entsorgungskalender/)
 - [AWB Esslingen](https://www.awb-es.de/)
+- [AWM München](https://www.awm-muenchen.de) ([Notes](#awm-münchen))
 - [Awista Starnberg](https://www.awista-starnberg.de/)
-- [AWM München](https://www.awm-muenchen.de)
+- [EAW Rheingau Taunus](https://www.eaw-rheingau-taunus.de/service/abfallkalender.html) ([Example](#eaw-rheingau-taunus))
 - [EDG Entsorgung Dortmund](https://www.edg.de/)
+- [Entsorgungsgesellschaft Görlitz-Löbau-Zittau](https://www.abfall-eglz.de/abfallkalender.0.html) ([Notes](#entsorgungsgesellschaft-görlitz-löbau-zittau))
+- [Müllabfuhr-Deutschland](https://www.muellabfuhr-deutschland.de/) ([Notes](#müllabfuhr-deutschland))
 - [Stadtreinigung Leipzig](https://www.stadtreinigung-leipzig.de/)
-- [Entsorgungsgesellschaft Görlitz-Löbau-Zittau](https://www.abfall-eglz.de/abfallkalender.0.html) (Remove the year from the generated URL to always get the current year.)
-- [Abfallwirtschaft Kreis Böblingen](https://www.lrabb.de/start/Service+_+Verwaltung/Abfuhrtermine.html) (API from AbfallPlus / Abfall.IO)
-- [ASR Chemnitz](https://www.asr-chemnitz.de/kundenportal/entsorgungskalender/) (Service von https://asc.hausmuell.info/ics/ics.php)
-- [Müllabfuhr-Deutschland](https://www.muellabfuhr-deutschland.de/) (You need to find the direct ics export link for your region, e.g. [Weimarer Land, Bad Berka](https://www.muellabfuhr-deutschland.de/weimarer-land/location/0c595d1c-2cbc-4d19-ae81-df5318fceb7c/pickups))
 
 ### Sweden
 - [NSR Nordvästra Skåne](https://nsr.se/privat/allt-om-din-sophamtning/nar-toms-mitt-karl/tomningskalender/)
 
 ### United States of America
-- [ReCollect](https://recollect.net)
+- [ReCollect.net](https://recollect.net) ([Notes](#recollect))
 
 ## Configuration via configuration.yaml
 
@@ -84,8 +86,20 @@ Field in params dictionary to be replaced with current year (4 digits including
 
 Delimiter to split event summary into individual collection types. If your service puts multiple collections types which occur at the same day into a single event, this option can be used to separate the collection types again.
 
-## Examples
+## Examples and Notes
 
+***
+### Local file
+```yaml
+waste_collection_schedule:
+  sources:
+    - name: ics
+      args:
+        file: "test.ics"
+```
+
+***
+### AVL Ludwigsburg
 ```yaml
 waste_collection_schedule:
   sources:
@@ -95,14 +109,8 @@ waste_collection_schedule:
         offset: 1
 ```
 
-```yaml
-waste_collection_schedule:
-  sources:
-    - name: ics
-      args:
-        file: "test.ics"
-```
-
+***
+### Abfallkalender Zollernalbkreis
 ```yaml
 waste_collection_schedule:
   sources:
@@ -128,6 +136,8 @@ waste_collection_schedule:
         year_field: year
 ```
 
+***
+### EAW Rheingau Taunus
 ```yaml
 waste_collection_schedule:
   sources:
@@ -137,7 +147,8 @@ waste_collection_schedule:
         split_at: ","
 ```
 
-### Recollect.net
+***
+### ReCollect
 To get the URL, search your address in the recollect form of your home town, click "Get a calendar", then "Add to iCal". Finally, the URL under "Subscribe to calendar" is your ICS calendar link:
 ```
 webcal://recollect.a.ssl.fastly.net/api/places/BCCDF30E-578B-11E4-AD38-5839C200407A/services/208/events.en.ics?client_id=6FBD18FE-167B-11EC-992A-C843A7F05606
@@ -151,3 +162,40 @@ waste_collection_schedule:
         url: "https://recollect.a.ssl.fastly.net/api/places/BCCDF30E-578B-11E4-AD38-5839C200407A/services/208/events.en.ics",
         split_at: "\\, [and ]*",
 ```
+***
+### Entsorgungsgesellschaft Görlitz-Löbau-Zittau
+Remove the year from the generated URL to always get the current year.
+
+***
+### Müllabfuhr-Deutschland
+You need to find the direct ics export link for your region, e.g. [Weimarer Land, Bad Berka](https://www.muellabfuhr-deutschland.de/weimarer-land/location/0c595d1c-2cbc-4d19-ae81-df5318fceb7c/pickups).
+
+Known districts:
+
+- https://www.muellabfuhr-deutschland.de/burgenlandkreis
+- https://www.muellabfuhr-deutschland.de/saalekreis
+- https://www.muellabfuhr-deutschland.de/soemmerda
+- https://www.muellabfuhr-deutschland.de/weimarer-land
+
+```yaml
+waste_collection_schedule:
+  sources:
+    - name: ics
+      args:
+        url: https://www.muellabfuhr-deutschland.de/weimarer-land/location/0c595d1c-2cbc-4d19-ae81-df5318fceb7c/pickups/ical.ics
+```
+
+***
+### AWM München
+
+1. Find your ICS export link via the AWM web page
+2. Remove the cHash attribute
+3. Replace current year with {%Y}
+
+```yaml
+waste_collection_schedule:
+  sources:
+    - name: ics
+      args:
+        url: "https://www.awm-muenchen.de/entsorgen/abfuhrkalender?tx_awmabfuhrkalender_abfuhrkalender%5Bhausnummer%5D=2&tx_awmabfuhrkalender_abfuhrkalender%5Bleerungszyklus%5D%5BB%5D=1%2F2%3BG&tx_awmabfuhrkalender_abfuhrkalender%5Bleerungszyklus%5D%5BP%5D=1%2F2%3BU&tx_awmabfuhrkalender_abfuhrkalender%5Bleerungszyklus%5D%5BR%5D=001%3BG&tx_awmabfuhrkalender_abfuhrkalender%5Bsection%5D=ics&tx_awmabfuhrkalender_abfuhrkalender%5Bsinglestandplatz%5D=false&tx_awmabfuhrkalender_abfuhrkalender%5Bstandplatzwahl%5D=true&tx_awmabfuhrkalender_abfuhrkalender%5Bstellplatz%5D%5Bbio%5D=70114566&tx_awmabfuhrkalender_abfuhrkalender%5Bstellplatz%5D%5Bpapier%5D=70114566&tx_awmabfuhrkalender_abfuhrkalender%5Bstellplatz%5D%5Brestmuell%5D=70114566&tx_awmabfuhrkalender_abfuhrkalender%5Bstrasse%5D=Freimanner%20Bahnhofstr.&tx_awmabfuhrkalender_abfuhrkalender%5Byear%5D={%Y}}
+```