updates documentation, adds screenshot

README.md

@@ -1,13 +1,40 @@
 # Open Rowing Monitor
 
 <!-- markdownlint-disable-next-line no-inline-html -->
-<img width="200" height="200" align="left" src="doc/img/openrowingmonitor.png">
+<img width="200" height="200" align="left" src="doc/img/openrowingmonitor_icon.png">
 
 An open source rowing monitor for rowing exercise machines.
 
-Open Rowing Monitor runs on a Raspberry Pi and measures the rotation of the rower's flywheel to calculate rowing specific metrics such as power, split time, speed, stroke rate, distance and calories.
+Open Rowing Monitor is a Node.js application that runs on a Raspberry Pi and measures the rotation of the rower's flywheel to calculate rowing specific metrics, such as power, split time, speed, stroke rate, distance and calories.
 
-A web interface visualizes those metrics on any device that can run a browser (i.e. a smartphone that you attach to your rowing machine while training).
+I currently develop and test it with a [Raspberry Pi 3 Modell B](https://www.raspberrypi.org/products/raspberry-pi-3-model-b/) and a Sportstech WRX700 waterrower. But it should run fine with any rowing machine that uses an air or water resistance mechanism as long as you can add something to measure the speed of the flywheel.
+I suspect it works well with DIY rowing machines like the [Openergo](https://openergo.webs.com) too.
+<!-- markdownlint-disable-next-line no-inline-html -->
+<br clear="left">
+
+## Features
+
+Currently the feature set is pretty basic, I'll add more features in the future, check the [Development Roadmap](doc/backlog.md) if you are curious.
+
+### Rowing Metrics
+
+Open Rowing Monitor implements a physics model to simulate the typical metrics of a rowing boat based on the pull on the handle. The physics model can be tuned to the specifics of a rower by changing some model parameters.
+
+* Stroke detection
+* Power (watts)
+* Split time (/500m)
+* Strokes per Minute
+* Calories used (kcal)
+* Training Duration
+
+### Web Interface
+
+The web interface visualizes the rowing metrics on any device that can run a browser (i.e. a smartphone that you attach to your rowing machine while training). It uses websockets to show the rowing status in realtime. Besides that it does not do much (yet).
+
+<!-- markdownlint-disable-next-line no-inline-html -->
+<img src="doc/img/openrowingmonitor_frontend.png" width="700"><br clear="left">
+
+### BLE FTMS Support
 
 Open Rowing Monitor also implements the Bluetooth Low Energy (BLE) protocol for Fitness Machine Service (FTMS). This allows using your rowing machine with any Fitness Application that supports FTMS.
 
@@ -17,14 +44,18 @@ FTMS supports different types of fitness machines. Open Rowing Monitor currently
 
 **FTMS Indoor Bike** is widely adopted by training applications for bike training. The simulated Indoor Bike offers metrics such as power and distance to the biking application. So why not use your rowing machine to row up a mountain in Zwift, Bkool, Sufferfest or similar :-)
 
-I originally started this project, because my rowing machine (WRX700) has a very simple computer and I wanted to build something with a clean interface that calculates more realistic metrics. But there is not much that is specific to that rowing machine. It should run fine with any rowing machine that uses an air or water resistance mechanism.
+## Why it all started
 
-Feel free to contact me if you have any questions about this project. Let me know if you run Open Rowing Machine with a different setup so I can expand the documentation.
+I originally started this project, because my rowing machine (Sportstech WRX700) has a very simple computer and I wanted to build something with a clean and simple interface that calculates more realistic metrics.
+
+The original proof of concept version started as a sketch on an ardunio, but when I started adding things like a web frontend and BLE I moved it to the much more powerful Raspberry Pi. Maybe using a Raspi for this small IoT-project is a bit of an overkill, but it has the capacity for further features such as syncing training data or rowing games. And it has USB-Ports that I can use to charge my phone while rowing :-)
+
+## Further information
 
 This project is already in a very usable stage, but some things are still a bit rough on the edges.
 
-For now, here are some basic [Installation Instructions](doc/installation.md)
+Feel free to leave a message in the [GitHub Discussions](https://github.com/laberning/openrowingmonitor/discussions) if you have any questions or ideas related to this project.
 
-Probably I'll add more features in the future, check the [Development Roadmap](doc/backlog.md) if you are curious.
+Here are some basic [Installation Instructions](doc/installation.md).
 
-This project uses some great work by others, see the [attribution here](doc/attribution.md).
+This project uses some great work by others, see the [attribution here](doc/attribution.md).

doc/backlog.md

@@ -8,7 +8,7 @@ This is the very minimalistic Backlog for further development of this project.
 * check todo markers in code and add them to this backlog
 * cleanup of the server.js start file
 * figure out where to set the Service Advertising Data (FTMS.pdf p 15)
-* Web UI: Replace Fullscreen Button with Exit Button when started from Homescreen
+* Web UI: replace fullscreen button with exit Button when started from homescreen
 * investigate bug: crash, when one unsubscribe to BLE "Generic Attribute", probably a bleno bug "handleAttribute.emit is not a function"
 * set up a raspi with the installation instructions to see if they are correct
 
@@ -16,7 +16,7 @@ This is the very minimalistic Backlog for further development of this project.
 
 * add a config file
 * presets for rowing machine specific config parameters
-* validate FTMS with more Training Applications and harden implementation
+* validate FTMS with more training applications and harden implementation
 * make Web UI a proper Web Application (tooling and SPA framework)
 * record the workout and show a visual graph of metrics
 * export the workout
@@ -24,6 +24,6 @@ This is the very minimalistic Backlog for further development of this project.
 ## Ideas
 
 * add support for BLE Heart Rate Sensor and show pulse
-* add Video playback in Background of Web UI
+* add video playback in background of Web UI
 * implement or integrate some rowing games
-* add possibility to define Workouts (i.e. training intervals with goals)
+* add possibility to define workouts (i.e. training intervals with goals)