Merge branch 'master' into master

Author: sugan0tech

.all-contributorsrc

@@ -2759,7 +2759,8 @@
       "avatar_url": "https://avatars.githubusercontent.com/u/141746282?v=4",
       "profile": "https://github.com/jnniu-n",
       "contributions": [
-        "translation"
+        "translation",
+        "doc"
       ]
     },
     {
@@ -2831,6 +2832,126 @@
       "name": "Doksanbir",
       "avatar_url": "https://avatars.githubusercontent.com/u/7249450?v=4",
       "profile": "https://github.com/ylcn91",
+      "contributions": [
+        "code",
+        "doc"
+      ]
+    },
+    {
+      "login": "Chant3ll3",
+      "name": "Chant3ll3",
+      "avatar_url": "https://avatars.githubusercontent.com/u/141697333?v=4",
+      "profile": "https://github.com/Chant3ll3",
+      "contributions": [
+        "doc",
+        "translation"
+      ]
+    },
+    {
+      "login": "hwan33",
+      "name": "YongHwan Kwon",
+      "avatar_url": "https://avatars.githubusercontent.com/u/67625677?v=4",
+      "profile": "https://hwan33.tistory.com/",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "takikuba",
+      "name": "Jakub Klimek",
+      "avatar_url": "https://avatars.githubusercontent.com/u/58841343?v=4",
+      "profile": "https://github.com/takikuba",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "bachbil",
+      "name": "believe",
+      "avatar_url": "https://avatars.githubusercontent.com/u/28935461?v=4",
+      "profile": "https://github.com/bachbil",
+      "contributions": [
+        "translation"
+      ]
+    },
+    {
+      "login": "egg0102030405",
+      "name": "egg0102030405",
+      "avatar_url": "https://avatars.githubusercontent.com/u/59650695?v=4",
+      "profile": "https://github.com/egg0102030405",
+      "contributions": [
+        "translation",
+        "doc"
+      ]
+    },
+    {
+      "login": "ved-asole",
+      "name": "Ved Asole",
+      "avatar_url": "https://avatars.githubusercontent.com/u/77259804?v=4",
+      "profile": "http://vedasole.cloud",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "Holiday-C",
+      "name": "NewMorning",
+      "avatar_url": "https://avatars.githubusercontent.com/u/95869761?v=4",
+      "profile": "https://github.com/Holiday-C",
+      "contributions": [
+        "translation"
+      ]
+    },
+    {
+      "login": "Kiro-Young",
+      "name": "资深老萌新",
+      "avatar_url": "https://avatars.githubusercontent.com/u/98251397?v=4",
+      "profile": "https://github.com/Kiro-Young",
+      "contributions": [
+        "translation"
+      ]
+    },
+    {
+      "login": "Nickolodeon98",
+      "name": "Seunghwan Jeon",
+      "avatar_url": "https://avatars.githubusercontent.com/u/113348293?v=4",
+      "profile": "https://itistori.tistory.com/",
+      "contributions": [
+        "translation"
+      ]
+    },
+    {
+      "login": "sugan0tech",
+      "name": "sugavanesh",
+      "avatar_url": "https://avatars.githubusercontent.com/u/71312159?v=4",
+      "profile": "https://github.com/sugan0tech",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "FinnS-F",
+      "name": "FinnS-F",
+      "avatar_url": "https://avatars.githubusercontent.com/u/126026830?v=4",
+      "profile": "https://github.com/FinnS-F",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "jerryyummy",
+      "name": "jerryyummy",
+      "avatar_url": "https://avatars.githubusercontent.com/u/62087610?v=4",
+      "profile": "https://github.com/jerryyummy",
+      "contributions": [
+        "translation"
+      ]
+    },
+    {
+      "login": "Manojkumarchow",
+      "name": "Manoj Chowdary",
+      "avatar_url": "https://avatars.githubusercontent.com/u/28005510?v=4",
+      "profile": "https://manojkumarchow.github.io/",
       "contributions": [
         "code"
       ]

README.md

@@ -10,7 +10,7 @@
 [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=coverage)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns)
 [![Join the chat at https://gitter.im/iluwatar/java-design-patterns](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/iluwatar/java-design-patterns?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-311-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-324-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 <br/>
@@ -464,7 +464,7 @@ This project is licensed under the terms of the MIT license.
     </tr>
     <tr>
       <td align="center" valign="top" width="14.28%"><a href="http://www.linkedin.com/in/yenniferh"><img src="https://avatars.githubusercontent.com/u/19285706?v=4?s=100" width="100px;" alt="Yennifer Herrera"/><br /><sub><b>Yennifer Herrera</b></sub></a><br /><a href="#translation-Yenniferh" title="Translation">🌍</a> <a href="https://github.com/iluwatar/java-design-patterns/pulls?q=is%3Apr+reviewed-by%3AYenniferh" title="Reviewed Pull Requests">👀</a></td>
-      <td align="center" valign="top" width="14.28%"><a href="https://github.com/jnniu-n"><img src="https://avatars.githubusercontent.com/u/141746282?v=4?s=100" width="100px;" alt="jnniu-n"/><br /><sub><b>jnniu-n</b></sub></a><br /><a href="#translation-jnniu-n" title="Translation">🌍</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/jnniu-n"><img src="https://avatars.githubusercontent.com/u/141746282?v=4?s=100" width="100px;" alt="jnniu-n"/><br /><sub><b>jnniu-n</b></sub></a><br /><a href="#translation-jnniu-n" title="Translation">🌍</a> <a href="https://github.com/iluwatar/java-design-patterns/commits?author=jnniu-n" title="Documentation">📖</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/miguel-is-coding"><img src="https://avatars.githubusercontent.com/u/48435117?v=4?s=100" width="100px;" alt="Miguel Angel Perez Garcia"/><br /><sub><b>Miguel Angel Perez Garcia</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/pulls?q=is%3Apr+reviewed-by%3Amiguel-is-coding" title="Reviewed Pull Requests">👀</a> <a href="#translation-miguel-is-coding" title="Translation">🌍</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/SuwanSankaja"><img src="https://avatars.githubusercontent.com/u/86839778?v=4?s=100" width="100px;" alt="Suwan Sankaja"/><br /><sub><b>Suwan Sankaja</b></sub></a><br /><a href="#translation-SuwanSankaja" title="Translation">🌍</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/Iamalok007"><img src="https://avatars.githubusercontent.com/u/97467835?v=4?s=100" width="100px;" alt="alok"/><br /><sub><b>alok</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=Iamalok007" title="Documentation">📖</a></td>
@@ -474,7 +474,24 @@ This project is licensed under the terms of the MIT license.
     <tr>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/jppf22"><img src="https://avatars.githubusercontent.com/u/104360594?v=4?s=100" width="100px;" alt="João Fernandes"/><br /><sub><b>João Fernandes</b></sub></a><br /><a href="#translation-jppf22" title="Translation">🌍</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/HongGeonUi"><img src="https://avatars.githubusercontent.com/u/89684956?v=4?s=100" width="100px;" alt="Hong Geon-ui"/><br /><sub><b>Hong Geon-ui</b></sub></a><br /><a href="#translation-HongGeonUi" title="Translation">🌍</a></td>
-      <td align="center" valign="top" width="14.28%"><a href="https://github.com/ylcn91"><img src="https://avatars.githubusercontent.com/u/7249450?v=4?s=100" width="100px;" alt="Doksanbir"/><br /><sub><b>Doksanbir</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=ylcn91" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/ylcn91"><img src="https://avatars.githubusercontent.com/u/7249450?v=4?s=100" width="100px;" alt="Doksanbir"/><br /><sub><b>Doksanbir</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=ylcn91" title="Code">💻</a> <a href="https://github.com/iluwatar/java-design-patterns/commits?author=ylcn91" title="Documentation">📖</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/Chant3ll3"><img src="https://avatars.githubusercontent.com/u/141697333?v=4?s=100" width="100px;" alt="Chant3ll3"/><br /><sub><b>Chant3ll3</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=Chant3ll3" title="Documentation">📖</a> <a href="#translation-Chant3ll3" title="Translation">🌍</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://hwan33.tistory.com/"><img src="https://avatars.githubusercontent.com/u/67625677?v=4?s=100" width="100px;" alt="YongHwan Kwon"/><br /><sub><b>YongHwan Kwon</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=hwan33" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/takikuba"><img src="https://avatars.githubusercontent.com/u/58841343?v=4?s=100" width="100px;" alt="Jakub Klimek"/><br /><sub><b>Jakub Klimek</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=takikuba" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/bachbil"><img src="https://avatars.githubusercontent.com/u/28935461?v=4?s=100" width="100px;" alt="believe"/><br /><sub><b>believe</b></sub></a><br /><a href="#translation-bachbil" title="Translation">🌍</a></td>
+    </tr>
+    <tr>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/egg0102030405"><img src="https://avatars.githubusercontent.com/u/59650695?v=4?s=100" width="100px;" alt="egg0102030405"/><br /><sub><b>egg0102030405</b></sub></a><br /><a href="#translation-egg0102030405" title="Translation">🌍</a> <a href="https://github.com/iluwatar/java-design-patterns/commits?author=egg0102030405" title="Documentation">📖</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="http://vedasole.cloud"><img src="https://avatars.githubusercontent.com/u/77259804?v=4?s=100" width="100px;" alt="Ved Asole"/><br /><sub><b>Ved Asole</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=ved-asole" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/Holiday-C"><img src="https://avatars.githubusercontent.com/u/95869761?v=4?s=100" width="100px;" alt="NewMorning"/><br /><sub><b>NewMorning</b></sub></a><br /><a href="#translation-Holiday-C" title="Translation">🌍</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/Kiro-Young"><img src="https://avatars.githubusercontent.com/u/98251397?v=4?s=100" width="100px;" alt="资深老萌新"/><br /><sub><b>资深老萌新</b></sub></a><br /><a href="#translation-Kiro-Young" title="Translation">🌍</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://itistori.tistory.com/"><img src="https://avatars.githubusercontent.com/u/113348293?v=4?s=100" width="100px;" alt="Seunghwan Jeon"/><br /><sub><b>Seunghwan Jeon</b></sub></a><br /><a href="#translation-Nickolodeon98" title="Translation">🌍</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/sugan0tech"><img src="https://avatars.githubusercontent.com/u/71312159?v=4?s=100" width="100px;" alt="sugavanesh"/><br /><sub><b>sugavanesh</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=sugan0tech" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/FinnS-F"><img src="https://avatars.githubusercontent.com/u/126026830?v=4?s=100" width="100px;" alt="FinnS-F"/><br /><sub><b>FinnS-F</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=FinnS-F" title="Code">💻</a></td>
+    </tr>
+    <tr>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/jerryyummy"><img src="https://avatars.githubusercontent.com/u/62087610?v=4?s=100" width="100px;" alt="jerryyummy"/><br /><sub><b>jerryyummy</b></sub></a><br /><a href="#translation-jerryyummy" title="Translation">🌍</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://manojkumarchow.github.io/"><img src="https://avatars.githubusercontent.com/u/28005510?v=4?s=100" width="100px;" alt="Manoj Chowdary"/><br /><sub><b>Manoj Chowdary</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=Manojkumarchow" title="Code">💻</a></td>
     </tr>
   </tbody>
 </table>

abstract-document/README.md

@@ -3,19 +3,18 @@ title: Abstract Document
 category: Structural
 language: en
 tag: 
- - Extensibility
+ - Abstraction
+ - Extensibility 
+ - Decoupling
 ---
 
 ## Intent
 
-The "Abstract Document" design pattern is a structural design pattern that aims to provide a consistent way to handle 
-hierarchical and tree-like data structures by defining a common interface for various document types.
+The Abstract Document design pattern is a structural design pattern that aims to provide a consistent way to handle hierarchical and tree-like data structures by defining a common interface for various document types. It separates the core document structure from specific data formats, enabling dynamic updates and simplified maintenance.
 
 ## Explanation
 
-The Abstract Document pattern enables handling additional, non-static properties. This pattern
-uses concept of traits to enable type safety and separate properties of different classes into
-set of interfaces.
+The Abstract Document pattern enables handling additional, non-static properties. This pattern uses concept of traits to enable type safety and separate properties of different classes into set of interfaces.
 
 Real world example
 
@@ -27,16 +26,11 @@ In plain words
 
 Wikipedia says
 
-> An object-oriented structural design pattern for organizing objects in loosely typed key-value stores and exposing 
-the data using typed views. The purpose of the pattern is to achieve a high degree of flexibility between components 
-in a strongly typed language where new properties can be added to the object-tree on the fly, without losing the 
-support of type-safety. The pattern makes use of traits to separate different properties of a class into different 
-interfaces.
+> An object-oriented structural design pattern for organizing objects in loosely typed key-value stores and exposing the data using typed views. The purpose of the pattern is to achieve a high degree of flexibility between components in a strongly typed language where new properties can be added to the object-tree on the fly, without losing the support of type-safety. The pattern makes use of traits to separate different properties of a class into different interfaces.
 
 **Programmatic Example**
 
-Let's first define the base classes `Document` and `AbstractDocument`. They basically make the object hold a property
-map and any amount of child objects.
+Let's first define the base classes `Document` and `AbstractDocument`. They basically make the object hold a property map and any amount of child objects.
 
 ```java
 public interface Document {
@@ -81,8 +75,7 @@ public abstract class AbstractDocument implements Document {
   ...
 }
 ```
-Next we define an enum `Property` and a set of interfaces for type, price, model and parts. This allows us to create
-static looking interface to our `Car` class.
+Next we define an enum `Property` and a set of interfaces for type, price, model and parts. This allows us to create  static looking interface to our `Car` class.
 
 ```java
 public enum Property {
@@ -176,9 +169,7 @@ And finally here's how we construct and use the `Car` in a full example.
 
 ## Applicability
 
-This pattern is particularly useful in scenarios where you have different types of documents that share some common 
-attributes or behaviors, but also have unique attributes or behaviors specific to their individual types. Here are 
-some scenarios where the Abstract Document design pattern can be applicable:
+This pattern is particularly useful in scenarios where you have different types of documents that share some common attributes or behaviors, but also have unique attributes or behaviors specific to their individual types. Here are some scenarios where the Abstract Document design pattern can be applicable:
 
 * Content Management Systems (CMS): In a CMS, you might have various types of content such as articles, images, videos, etc. Each type of content could have shared attributes like creation date, author, and tags, while also having specific attributes like image dimensions for images or video duration for videos.
 
@@ -194,13 +185,36 @@ some scenarios where the Abstract Document design pattern can be applicable:
 
 * Project Management Tools: In project management applications, you could have different types of tasks like to-do items, milestones, and issues. The Abstract Document pattern could be used to handle general attributes like task name and assignee, while allowing for specific attributes like milestone date or issue priority.
 
-The key idea behind the Abstract Document design pattern is to provide a flexible and extensible way to manage different 
-types of documents or entities with shared and distinct attributes. By defining a common interface and implementing it 
-across various document types, you can achieve a more organized and consistent approach to handling complex data 
-structures.
+* Documents have diverse and evolving attribute structures.
+
+* Dynamically adding new properties is a common requirement.
+
+* Decoupling data access from specific formats is crucial.
+
+* Maintainability and flexibility are critical for the codebase.
+
+The key idea behind the Abstract Document design pattern is to provide a flexible and extensible way to manage different types of documents or entities with shared and distinct attributes. By defining a common interface and implementing it across various document types, you can achieve a more organized and consistent approach to handling complex data structures.
+
+## Consequences
+
+Benefits
+
+* Flexibility: Accommodates varied document structures and properties.
+
+* Extensibility: Dynamically add new attributes without breaking existing code.
+
+* Maintainability: Promotes clean and adaptable code due to separation of concerns.
+
+* Reusability: Typed views enable code reuse for accessing specific attribute types.
+
+Trade-offs
+
+* Complexity: Requires defining interfaces and views, adding implementation overhead.
+
+* Performance: Might introduce slight performance overhead compared to direct data access.
 
 ## Credits
 
 * [Wikipedia: Abstract Document Pattern](https://en.wikipedia.org/wiki/Abstract_Document_Pattern)
 * [Martin Fowler: Dealing with properties](http://martinfowler.com/apsupp/properties.pdf)
-* [Pattern-Oriented Software Architecture Volume 4: A Pattern Language for Distributed Computing (v. 4)](https://www.amazon.com/gp/product/0470059028/ref=as_li_qf_asin_il_tl?ie=UTF8&tag=javadesignpat-20&creative=9325&linkCode=as2&creativeASIN=0470059028&linkId=e3aacaea7017258acf184f9f3283b492)
+* [Pattern-Oriented Software Architecture Volume 4: A Pattern Language for Distributed Computing (v. 4)](https://amzn.to/49zRP4R)