diff --git a/microservice-server/README.md b/microservice-server/README.md
index 4b84061a974a89ca72d8a7fb8067523145ff4ecc..f1089d807bd676685129a7481e9c398f801ca3f6 100644
--- a/microservice-server/README.md
+++ b/microservice-server/README.md
@@ -32,7 +32,11 @@ JSON object mapper interface and implementations.
 Logging interface and implementation.
 
 ### ch.ethz.sis.microservices.server.services ###
-Service interface and implementation.
+Service interface and implementations.
+
+To implement a new service is sufficient to extend the class ch.ethz.sis.microservices.server.services.Service. This class extends the standard J2EE HttpServlet and is up to the implementer to decide to accept the different http methods.
+
+This class just provides a convenience method getServiceConfig() to retrieve the configuration.
 
 ### ch.ethz.sis.microservices.server.startup ###
 Main class and launcher.