home.md

@@ -16,11 +16,11 @@
 ## Modules
 These are the different modules of the spear project:
 
-* **[SPEAR Model](module/model) - this contains the SPEAR metamodel; it comprises different aspects, that were modules in their own right in an earlier version, but were merged to the single `model` module later
+* **[SPEAR Model](module/model)** - this contains the SPEAR metamodel; it comprises different aspects, that were modules in their own right in an earlier version, but were merged to the single `model` module later
   * **[Energy Context](module/energy-context)** - it manages the data, which describes the different energy sources and their (prognosed) availability and price
   * **[Optimisation Configuration](module/optimisation-configuration)** - it manages the current requirements of the user, regarding the optimisation
   * **[Production Infrastructure](module/production-infrastructure)** - it manages the data, which describes the whole production infrastructure (machines, cells, tasks, products etc.)
 * **[Optimisation](module/optimisation)** - it creates the optimised production schedule
-* **[GUI](module/gui)**
-* **[REST-API](module/rest-api)**
-* **[REST-Interface](module/rest-interface)**
\ No newline at end of file
+* **[GUI](module/gui)** - a simple Java FX based GUI for locally testing, debugging and monitoring the optimization; this is _not_ the actual user interface to be used by the end user
+* **[REST-API](module/rest-api)** - describes the public API of the SPEAR optimization as provided by the `rest-interface` and defines a second model, mirroring the primary `model`, to be used for REST requests and responses
+* **[REST-Interface](module/rest-interface)** - provides REST services for calling the SPEAR optimization using Spring Boot, and also provides a simple Web interface using Swagger as well as a simple landing page with some basic infos and links; this is to be used by the partners at Let's Dev who provide the actual user interface
\ No newline at end of file