diff --git a/bundles/org.openhab.binding.bluetooth.grundfosalpha/README.md b/bundles/org.openhab.binding.bluetooth.grundfosalpha/README.md
index d0d081451e23a..e9b12ba711d43 100644
--- a/bundles/org.openhab.binding.bluetooth.grundfosalpha/README.md
+++ b/bundles/org.openhab.binding.bluetooth.grundfosalpha/README.md
@@ -28,10 +28,22 @@ All readers are auto-detected as soon as Bluetooth is configured in openHAB and
 | flow-rate        | Number:VolumetricFlowRate | R          | The flow rate of the pump          |
 | pump-head        | Number:Length             | R          | The water head above the pump      |
 | pump-temperature | Number:Temperature        | R          | The temperature of the pump        |
-| battery-level    | Number:Percent            | R          | The battery level of the reader    |
+| battery-level    | Number:Dimensionless      | R          | The battery level of the reader    |
 
 ## Full Example
 
-_Provide a full usage example based on textual configuration files._
-_*.things, *.items examples are mandatory as textual configuration is well used by many users._
-_*.sitemap examples are optional._
+grundfos_alpha.things (assuming you have a Bluetooth bridge with the ID `bluetooth:bluegiga:adapter1`:
+
+```
+bluetooth:mi401:hci0:sensor1 "Grundfos Alpha Reader 1" (bluetooth:bluegiga:adapter1) [ address="12:34:56:78:9A:BC" ]
+```
+
+grundfos_alpha.items:
+
+```
+Number RSSI "RSSI [%.1f dBm]" <QualityOfService> { channel="bluetooth:mi401:hci0:sensor1:rssi" }
+Number:VolumetricFlowRate Flow_rate "Flowrate [%.1f %unit%]" <flow> { channel="bluetooth:mi401:hci0:sensor1:flow-rate" }
+Number:Length Pump_Head "Pump head [%.1f %unit%]" <water> { channel="bluetooth:mi401:hci0:sensor1:pump-head" }
+Number:Temperature Pump_Temperature "Temperature [%.1f %unit%]" <temperature> { channel="bluetooth:mi401:hci0:sensor1:pump-temperature" }
+Number:Dimensionless Battery_Level "Battery Level [%d %%]" <Battery> { channel="bluetooth:mi401:hci0:sensor1:battery-level" }
+```
diff --git a/bundles/org.openhab.binding.bluetooth.grundfosalpha/src/main/resources/OH-INF/i18n/bluetooth.properties b/bundles/org.openhab.binding.bluetooth.grundfosalpha/src/main/resources/OH-INF/i18n/bluetooth.properties
new file mode 100644
index 0000000000000..aac110918b671
--- /dev/null
+++ b/bundles/org.openhab.binding.bluetooth.grundfosalpha/src/main/resources/OH-INF/i18n/bluetooth.properties
@@ -0,0 +1,18 @@
+# thing types
+
+thing-type.bluetooth.mi401.label = Grundfos Alpha Reader MI401
+thing-type.bluetooth.mi401.description = A Grundfos Alpha Reader MI401
+
+# thing types config
+
+thing-type.config.bluetooth.mi401.address.label = Address
+thing-type.config.bluetooth.mi401.address.description = Bluetooth address in XX:XX:XX:XX:XX:XX format
+
+# channel types
+
+channel-type.bluetooth.grundfos-flow.label = Current Flow
+channel-type.bluetooth.grundfos-flow.description = Current flow
+channel-type.bluetooth.grundfos-head.label = Current Head
+channel-type.bluetooth.grundfos-head.description = Current head
+channel-type.bluetooth.grundfos-temperature.label = Current Pump Temperature
+channel-type.bluetooth.grundfos-temperature.description = Current pump temperature
diff --git a/bundles/org.openhab.binding.bluetooth.grundfosalpha/src/main/resources/OH-INF/i18n/grundfosalpha.properties b/bundles/org.openhab.binding.bluetooth.grundfosalpha/src/main/resources/OH-INF/i18n/grundfosalpha.properties
deleted file mode 100644
index a2ff149f4f801..0000000000000
--- a/bundles/org.openhab.binding.bluetooth.grundfosalpha/src/main/resources/OH-INF/i18n/grundfosalpha.properties
+++ /dev/null
@@ -1,23 +0,0 @@
-# add-on
-
-addon.grundfosalpha.name = GrundfosAlpha Binding
-addon.grundfosalpha.description = This is the binding for Grundfos Alpha circulator pumps.
-
-# thing types
-
-thing-type.grundfosalpha.mi401.label = Grundfos Alpha Reader MI401
-thing-type.grundfosalpha.mi401.description = A Grundfos Alpha Reader MI401
-
-# thing types config
-
-thing-type.config.bluetooth.mi401.address.label = Address
-thing-type.config.bluetooth.mi401.address.description = Bluetooth address in XX:XX:XX:XX:XX:XX format
-
-# channel types
-
-channel-type.grundfosalpha.grundfos-flow.label = Current Flow
-channel-type.grundfosalpha.grundfos-flow.description = Current flow
-channel-type.grundfosalpha.grundfos-head.label = Current Head
-channel-type.grundfosalpha.grundfos-head.description = Current head
-channel-type.grundfosalpha.grundfos-temperature.label = Current Pump Temperature
-channel-type.grundfosalpha.grundfos-temperature.description = Current pump temperature