docs: Improve active object description

active-object/README.md

@@ -8,17 +8,22 @@ tag:
 
 
 ## Intent
-The active object design pattern decouples method execution from method invocation for objects that each reside in their thread of control. The goal is to introduce concurrency, by using asynchronous method invocation, and a scheduler for handling requests.
+
+The Active Object design pattern provides a safe and reliable way to implement asynchronous behavior in concurrent 
+systems. It achieves this by encapsulating tasks within objects that have their own thread and message queue. This 
+separation keeps the main thread responsive and avoids issues like direct thread manipulation or shared state access.
 
 ## Explanation
 
-The class that implements the active object pattern will contain a self-synchronization mechanism without using 'synchronized' methods.
+The class that implements the active object pattern will contain a self-synchronization mechanism without using 
+'synchronized' methods.
 
 Real-world example
 
 >The Orcs are known for their wildness and untameable soul. It seems like they have their own thread of control based on previous behavior.
 
-To implement a creature that has its own thread of control mechanism and expose its API only and not the execution itself, we can use the Active Object pattern.
+To implement a creature that has its own thread of control mechanism and expose its API only and not the execution 
+itself, we can use the Active Object pattern.
 
 
 **Programmatic Example**
@@ -79,7 +84,8 @@ public abstract class ActiveCreature{
 }
 ```
 
-We can see that any class that will extend the ActiveCreature class will have its own thread of control to invoke and execute methods.
+We can see that any class that will extend the ActiveCreature class will have its own thread of control to invoke and 
+execute methods.
 
 For example, the Orc class:
 
@@ -93,7 +99,8 @@ public class Orc extends ActiveCreature {
 }
 ```
 
-Now, we can create multiple creatures such as Orcs, tell them to eat and roam, and they will execute it on their own thread of control:
+Now, we can create multiple creatures such as Orcs, tell them to eat and roam, and they will execute it on their own 
+thread of control:
 
 ```java
   public static void main(String[] args) {  
@@ -122,6 +129,41 @@ Now, we can create multiple creatures such as Orcs, tell them to eat and roam, a
 
 ![alt text](./etc/active-object.urm.png "Active Object class diagram")
 
+## Applicability
+
+* When you need to perform long-running operations without blocking the main thread.
+* When you need to interact with external resources asynchronously.
+* When you want to improve the responsiveness of your application.
+* When you need to manage concurrent tasks in a modular and maintainable way.
+
 ## Tutorials
 
-* [Android and Java Concurrency: The Active Object Pattern](https://www.youtube.com/watch?v=Cd8t2u5Qmvc)
+* [Android and Java Concurrency: The Active Object Pattern](https://www.youtube.com/watch?v=Cd8t2u5Qmvc)
+
+## Consequences
+
+Benefits
+
+* Improves responsiveness of the main thread.
+* Encapsulates concurrency concerns within objects.
+* Promotes better code organization and maintainability.
+* Provides thread safety and avoids shared state access problems.
+
+Trade-offs
+
+* Introduces additional overhead due to message passing and thread management.
+* May not be suitable for all types of concurrency problems.
+
+## Related patterns
+
+* Observer
+* Reactor
+* Producer-consumer
+* Thread pool
+
+## Credits
+
+* [Design Patterns: Elements of Reusable Object Software](https://amzn.to/3HYqrBE)
+* [Concurrent Programming in Java: Design Principles and Patterns](https://amzn.to/498SRVq)
+* [Learning Concurrent Programming in Scala](https://amzn.to/3UE07nV)
+* [Pattern Languages of Program Design 3](https://amzn.to/3OI1j61)