diff --git a/firmware/README.md b/firmware/README.md
index 6cdd646e2e9917e964b4da501c82006b5bc4390a..167f55519a9ecc9e7ad08d1e5da01671378afff3 100644
--- a/firmware/README.md
+++ b/firmware/README.md
@@ -1,5 +1,6 @@
 
 # firmware.freifunk.lu
 
-This will install a default firmware nginx config.
+Installs a default firmware nginx config.
+
 Before executing please check your hosts file and use hosts variable.
diff --git a/gateway/README.md b/gateway/README.md
index 8da30aa46a9571d97ff1528aeffebb03694f173a..2d94bc0c59562779b17610402b199fb8aaf911ea 100644
--- a/gateway/README.md
+++ b/gateway/README.md
@@ -1,7 +1,11 @@
 
 # Gateway Setup
 
-This will install fflux gateways.
-auth file need to be added manually.
-For new gateways, please update ansible host fles and concerning ips and mac addresses. Also new fastd keys need to be generated manually.
-Update Firmware sync script.
+Installs fflux gateways.
+
+Note: auth file need to be added manually.
+
+For new gateways:
+
+- update ansible host files + concerning ips and mac addresses
+- new fastd keys need to be generated manually.