documentation update

README.md

@@ -1,3 +1,13 @@
+**_mTimer_ is a mod for showing ingame and reallife times and periods**
+
+## Description
+
+*mTimer* is a mod that allows players to individually configure and show a timer as permanent HUD element that automatically updates every second. The timer can show the real-world time and the ingame time as well as the current play session starting time and duration in freely configurable formats.
+
+![Main Menu](screenshots/hud_element.png)
+
+Use it on your public servers to give your players additional value (players can individually hide the timer if they want) while being on your server or use it in your singleplayer world to stay informed or – when creating creative content for others to watch – give your viewers a hint on when the footage was recorded.
+
 ## Configuration
 
 The timer display and settings are entirely configured on a per-player basis via configuration formspecs. Configurations are set when leaving the formspec via the buttons or when pressing enter or clicking the apply button (where available). Pressing the escape key cancels the changes.
@@ -8,6 +18,8 @@ For opening the main menu simply enter the `/mtimer` chat command. From the main
 
 Simply click the button of the option you want to configure.
 
+Configuration formspecs can be accessed directly by providing the respective parameter to the `/mtimer` chat command. Run `/mtimer help` to see a list of available parameters. You might need to bring up the console (F12 by defualt) to see all available parameters because the chat display might be too small.
+
 ### Variables
 
 Some formspecs allow you to use variables. The variables and their current (i.e. the moment when opening the formspec) values are shown below the input field.