Updated README

Author: naturalprogrammer

README.md

@@ -9,21 +9,40 @@ When developing **real-world** Spring REST APIs and microservices, you face many
 1. How to handle _validations_ and _exceptions_ in a cross functional manner and send precise errors to the client.
 1. How exactly to support multiple _social sign up/in_, using _OpenID Connect_ or _OAuth2_ providers such as _Google_ and _Facebook_.
 1. How to code a robust user module (with features like _sign up_, _sign in_, _verify email_, _social sign up/in_, _update profile_, _forgot password_, _change password_, _change email_, _token authentication_ etc.) and share it across all your applications.
-1. _What would be good ways to test your API_.
+1. How to _secure microservices_ effeciently, using long-lived and short-lived JWTs.
+1. What would be good ways to _test your API_.
 1. How to do _Captcha validation_.
 1. How to properly organize _application properties_.
 1. How to use _PATCH_ and _JsonPatch_ to handle partial updates correctly.
 1. How to do all the above reactively, using WebFlux and WebFlux security.
 
 Coding all this rightly needs in-depth knowledge of Spring. It also takes a lot of development time and effort, and needs to be properly maintained as new versions of Spring modules come out.
 
-**Spring Lemon** relieves you of all this burden. It's a tiny open source library holding all these common configuration and components, and also a production grade user module with all the abovementioned features.
+**Spring Lemon** relieves you of all this burden. It's a set of configurable and extensible libraries, providing all above features. Use these to develop quality reactive or non-reactive monolith or microservices applications easily.  
 
-Even if you don't plan to use Spring Lemon, it's a good example application to learn from, because it showcases the essential best practices for developing elegant web services and microservices using Spring.
+Even if you don't plan to use Spring Lemon, it's a good example to learn from, because it showcases the essential best practices for developing elegant web services and microservices using Spring.
 
 Most Spring Boot applications can use Spring Lemon straight away, with some simple configurations. But, if you don't find it suitable for your application, feel free to fork it, or just roll out your own library by learning its patterns and practices. Better yet, be a contributor!
 
-Watch [this video tutorial](https://www.naturalprogrammer.com/p/spring-lemon-restful-web-services-development) or read [this quick starter guide](https://github.com/naturalprogrammer/spring-lemon/wiki/Getting-Started-With-Spring-Lemon) for getting started.
+Read [this quick starter guide](https://github.com/naturalprogrammer/spring-lemon/wiki/Getting-Started-With-Spring-Lemon) or watch [this video tutorial](https://www.naturalprogrammer.com/p/spring-lemon-restful-web-services-development) for getting started.
+
+## Libraries hierarchy
+
+* **spring-lemon-exceptions**: Useful for elegant exception handling and validation in any Spring project
+    * **spring-lemon-commons**: Common for all things below
+        * **spring-lemon-commons-web**: For developing Spring Web (non-reactive) microservices
+            * **spring-lemon-commons-jpa**: For developing Spring Web (non-reactive) JPA microservices
+                * **spring-lemon-jpa**: For developing Spring Web (non-reactive) JPA monolith or auth-microservice
+        * **spring-lemon-commons-reactive**: For developing Spring WebFlux (reactive) microservices
+            * **spring-lemon-commons-mongo**: For developing Spring WebFlux (reactive) MongoDB microservices
+                * **spring-lemon-rective**: For developing Spring WebFlux (reactive) MongoDB monolith or auth-microservice
+
+For example usage, see
+
+* [Demo non-reactive monolith](https://github.com/naturalprogrammer/spring-lemon/tree/master/lemon-demo-jpa)
+* [Demo reactive monolith](https://github.com/naturalprogrammer/spring-lemon/tree/master/lemon-demo-reactive)
+* [Demo non-reactive microservices](https://github.com/naturalprogrammer/np-microservices-sample-01) and its [configuration repository](https://github.com/naturalprogrammer/np-microservices-sample-01-config)
+* [Demo reactive microservices](https://github.com/naturalprogrammer/np-microservices-sample-02) and its [configuration repository](https://github.com/naturalprogrammer/np-microservices-sample-02-config)
 
 ## Documentation and Resources
 
@@ -33,10 +52,13 @@ Watch [this video tutorial](https://www.naturalprogrammer.com/p/spring-lemon-res
 1. _Getting started guide_
    1. [Book](https://github.com/naturalprogrammer/spring-lemon/wiki/Getting-Started-With-Spring-Lemon)
    1. [Video Tutorial](https://www.naturalprogrammer.com/p/spring-lemon-restful-web-services-development)
-1. _Example applications_ — [Non-reactive](https://github.com/naturalprogrammer/spring-lemon/tree/master/lemon-demo-jpa) and [reactive](https://github.com/naturalprogrammer/spring-lemon/tree/master/lemon-demo-reactive) sample applications using Spring Lemon. Quite similar to the one developed in the above [getting started guide](https://github.com/naturalprogrammer/spring-lemon/wiki/Getting-Started-With-Spring-Lemon), but additionally have automated tests.
-1. _[API documentation](https://documenter.getpostman.com/view/305915/RVu2mqEH)_ of the above application.
-1. _[Example AngularJS front-end application](https://github.com/naturalprogrammer/spring-lemon/tree/master/lemon-demo-angularjs)_ — A sample AngularJS 1.x front-end. It'll work both for the application developed in the above [getting started guide](https://github.com/naturalprogrammer/spring-lemon/wiki/Getting-Started-With-Spring-Lemon) as well as the [Lemon Demo application](https://github.com/naturalprogrammer/spring-lemon/tree/master/lemon-demo-jpa). See the [Getting Started Guide](https://github.com/naturalprogrammer/spring-lemon/wiki/Getting-Started-With-Spring-Lemon) on how to use it.
-1. _[Example reactive microservices](https://github.com/naturalprogrammer/np-microservices-sample-02) using Spring Lemon, and its [configuration repo](https://github.com/naturalprogrammer/np-microservices-sample-02-config)_ — A sample reactive microservices application depicting how easy it is to develop reactive microservices using Spring Lemon.
+1. _Example applications_
+    * [Demo non-reactive monolith](https://github.com/naturalprogrammer/spring-lemon/tree/master/lemon-demo-jpa)
+    * [Demo reactive monolith](https://github.com/naturalprogrammer/spring-lemon/tree/master/lemon-demo-reactive)
+    * [Demo non-reactive microservices](https://github.com/naturalprogrammer/np-microservices-sample-01) and its [configuration repository](https://github.com/naturalprogrammer/np-microservices-sample-01-config)
+    * [Demo reactive microservices](https://github.com/naturalprogrammer/np-microservices-sample-02) and its [configuration repository](https://github.com/naturalprogrammer/np-microservices-sample-02-config)
+1. _[API documentation](https://documenter.getpostman.com/view/305915/RVu2mqEH)_ of the above applications.
+1. _[Example AngularJS front-end application](https://github.com/naturalprogrammer/spring-lemon/tree/master/lemon-demo-angularjs)_ — A sample AngularJS 1.x front-end. It'll work for the application developed in the above [getting started guide](https://github.com/naturalprogrammer/spring-lemon/wiki/Getting-Started-With-Spring-Lemon) as well all the above example applications. See the [Getting Started Guide](https://github.com/naturalprogrammer/spring-lemon/wiki/Getting-Started-With-Spring-Lemon) on how to use it.
 1. _[Spring Framework Recipes For Real World Application Development](https://www.naturalprogrammer.com/p/spring-framework-book-of-best-practices)_ — a live book discussing key real-world topics on developing Spring applications, APIs and microservoces. Includes many Spring Lemon topics. [Click here](https://www.naturalprogrammer.com/p/spring-framework-book-of-best-practices) to get it now for FREE!
 1. Video tutorials coming soon:
    1. Spring Framework 5 REST API Development — A Complete Blueprint For Real-World Developers