Update README

Author: arthurkehrwald

README.md

@@ -2,52 +2,52 @@
 
 [![UPM Package](https://img.shields.io/npm/v/org.visualpinball.engine.missionpinball?label=org.visualpinball.engine.missionpinball&registry_uri=https://registry.visualpinball.org&color=%2333cf57&logo=unity&style=flat)](https://registry.visualpinball.org/-/web/detail/org.visualpinball.engine.missionpinball)
 
-*Enables the Mission Pinball Framework to drive VPE*
+_Enables the Mission Pinball Framework to drive VPE_
+
+Documentation at <https://docs.visualpinball.org/plugins/mpf/>
 
 ## Overview
 
-[MPF](https://missionpinball.org/latest/about/)  is an open-source framework 
+[MPF](https://missionpinball.org/latest/about/) is an open-source framework
 written in Python to drive real pinball machines. It has a "configuration over
-code" approach, meaning that 90% of what you'd do in a pinball game can be 
+code" approach, meaning that 90% of what you'd do in a pinball game can be
 achieved through configuration (YAML files) rather than implementing it in code.
 
 When you read MPF's [Getting Started](https://missionpinball.org/latest/start/)
-page, you'll notice a banner stating that "MPF is not a simulator." Well, 
-you've found the simulator. ;)
-
-This project lets you use MPF to drive game logic in [VPE](https://github.com/freezy/VisualPinball.Engine), 
-a pinball simulator based on Unity. It does this by spawning a Python process running
-MPF and communicating with VPE through [gRPC](https://grpc.io/).
-
-### Installation
-
-This project is available as a Unity package at `registry.visualpinball.org`. 
-To install it, make sure the scoped registry is added in your Package Manager 
-settings. Then open the Package Manager in Unity and add 
-`org.visualpinball.engine.missionpinball` under *Install package by name*.
-
-The Unity package is build and published to our registry on every merge to master.
+page, you'll notice a banner stating that "MPF is not a simulator." Well, you've
+found the simulator. ;)
 
-## Setup
+This project lets you use MPF to drive game logic in
+[VPE](https://github.com/freezy/VisualPinball.Engine), a pinball simulator based
+on Unity. It does this by spawning a Python process running MPF and
+communicating with VPE through [gRPC](https://grpc.io/).
 
-You currently need Python and MPF installed locally.
+## User setup
 
-1. Install Python 3
-2. `pip install --pre mpf mpf-mc`
+This project is available as a Unity package at `registry.visualpinball.org`. To
+install it, make sure the scoped registry is added in your Package Manager
+settings. Then open the Package Manager in Unity and add
+`org.visualpinball.engine.missionpinball` under _Install package by name_.
 
-Or, if you already have it:
+The Unity package is built and published to our registry on every merge to
+master.
 
-`pip install mpf mpf-mc --pre --upgrade`
+# Use
 
-After that, `mpf --version` should return at least **MPF v0.55.0-dev.37**.
+1. Add the `MpfGamelogicEngine` component to the root object of your table
+2. Click on 'Get Machine Desciption' in its inspector
+3. Click on 'Populate Hardware' to bring the coils switches and lamps from MPFs
+   machine description into VPEs respective manager windows
+4. Assign the coils, switches and lamps to items on your playfield using the
+   coil, switch and lamp manager windows
 
 ## Development Setup
 
 In order to import the package locally instead from our registry, clone and
 compile it. This will copy the necessary binaries into the Unity folder. Only
 then, import the project into Unity.
 
-Since the Unity folder contains `.meta` files of the binaries, but not the 
+Since the Unity folder contains `.meta` files of the binaries, but not the
 actual binaries, `.meta` files of uncompiled platforms are cleaned up by Unity.
 In order to not accidentally commit those files, we recommend to ignore them:
 
@@ -71,4 +71,4 @@ git update-index --assume-unchanged Plugins/VisualPinball.Engine.Mpf.pdb.meta
 
 ## License
 
-[MIT](LICENSE)
+[MIT](LICENSE)