Merge branch 'develop' into feature/clean-resources

README.md

@@ -110,15 +110,18 @@ public interface ExampleService {
 ### Maven
 
 With scalecube-services you may plug-and-play alternative providers for Transport,Codecs and discovery. 
-Scalecube is using ServiceLoader to load providers from class path, currently supported providers: 
+Scalecube is using ServiceLoader to load providers from class path, 
+
+You can think about scalecube as slf4j for microservices - Currently supported SPIs: 
 
 **Transport providers:**
 
 * rsocket-services-transport: using rsocket to communicate with remote services.
 
 **Message codec providers:**
 
-* scalecube-services-jackson: using Jackson to encode / decode service messages.
+* scalecube-services-jackson: using Jackson to encode / decode service messages. https://github.com/FasterXML
+* scalecube-services-protostuff: using protostuff to encode / decode service messages. https://github.com/protostuff
 
 **Service discovery providers:**
 
@@ -130,46 +133,73 @@ Binaries and dependency information for Maven can be found at http://search.mave
 
 https://mvnrepository.com/artifact/io.scalecube
 
+[![Maven Central](https://maven-badges.herokuapp.com/maven-central/io.scalecube/scalecube-services-api/badge.svg)](https://maven-badges.herokuapp.com/maven-central/io.scalecube/scalecube-services-api)
+
 To add a dependency on ScaleCube Services using Maven, use the following:
 
 ```xml
- <!- scalecube apis   -->
+
+ <!-- -------------------------------------------
+   scalecube core and api:   
+ ------------------------------------------- -->
+
+ <!-- scalecube apis   -->
  <dependency>
   <groupId>io.scalecube</groupId>
   <artifactId>scalecube-services-api</artifactId>
   <version>2.x.x</version>
  </dependency>
 
- <!- scalecube services module   -->
+ <!-- scalecube services module   -->
  <dependency>
   <groupId>io.scalecube</groupId>
   <artifactId>scalecube-services</artifactId>
   <version>2.x.x</version>
  </dependency>
 
- <!- scalecube transport provider   -->
+
+ <!--
+
+     Plugins / SPIs: bellow a list of providers you may choose from. to constract your own configuration:
+     you are welcome to build/contribute your own plugins please consider the existing ones as example.
+
+  -->
+
+ <!-- -------------------------------------------
+   scalecube transport providers:   
+ ------------------------------------------- -->
  <dependency>
   <groupId>io.scalecube</groupId>
   <artifactId>rsocket-services-transport</artifactId>
   <version>2.x.x</version>
  </dependency>
 
- <!- jackson, protostuff or yours scalecube message serialization provider -->
+ <!-- -------------------------------------------
+   scalecube message serialization providers:
+   ------------------------------------------- -->
+
+ <!-- jackson scalecube messages codec -->
  <dependency>
   <groupId>io.scalecube</groupId>
   <artifactId>scalecube-services-jackson</artifactId>
   <version>2.x.x</version>
  </dependency>
+
+<!-- protostuff scalecube messages codec -->
  <dependency>
   <groupId>io.scalecube</groupId>
   <artifactId>scalecube-services-protostuff</artifactId>
   <version>2.x.x</version>
  </dependency>
 
- <!- scalecube service discovery provider   -->
+ <!-- -------------------------------------------
+    scalecube service discovery provider   
+   ------------------------------------------- -->
  <dependency>
   <groupId>io.scalecube</groupId>
   <artifactId>scalecube-services-discovery</artifactId>
   <version>2.x.x</version>
  </dependency>
+
+
 ```