matrix/uk.half-shot.matrix-hookshot.feed/README.md: check how hookshot configures state

matrix/uk.half-shot.matrix-hookshot.feed/README.md

@@ -0,0 +1,46 @@
+# hookshot room state configuration
+
+When Hookshot is configured via the manage integrations menu, it appears to
+perform two state installations/directories/whatever:
+
+- `uk.half-shot.matrix-hookshot.feed`
+  - contains state events with the feed name
+    - contains the json below
+- `io.element.integrations.installations`
+  - contains uuid below
+
+<!-- START doctoc generated TOC please keep comment here to allow auto update -->
+<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
+
+- [feed](#feed)
+- [installation](#installation)
+
+<!-- END doctoc generated TOC please keep comment here to allow auto update -->
+
+--
+
+## feed
+
+This entry is the feed url e.g.
+`https://feeds.yle.fi/uutiset/v1/recent.rss?publisherIds=YLE_NEWS`, and
+contains:
+
+```json
+{
+  "label": "YLE News in English",
+  "url": "https://feeds.yle.fi/uutiset/v1/recent.rss?publisherIds=YLE_NEWS"
+}
+```
+
+## installation
+
+This probably has or should be left for the integration manager.
+
+```json
+{
+  "appId": "hookshot-feeds",
+  "installationId": "uuid-goes-here",
+  "userIds": ["@feeds:integrations.ems.host"],
+  "widgetIds": []
+}
+```