From ca135d8abf81182c3b1018d5ba40b1586f4d3fa4 Mon Sep 17 00:00:00 2001
From: Zoltan Toth <contact@zoltantoth.com>
Date: Thu, 14 Mar 2019 10:48:32 -0400
Subject: [PATCH 1/4] Add description and use fields to creational patterns

---
 src/static/patterns/creational_abstractFactory.js | 5 ++++-
 src/static/patterns/creational_builder.js         | 5 ++++-
 src/static/patterns/creational_factory.js         | 4 +++-
 src/static/patterns/creational_prototype.js       | 4 +++-
 src/static/patterns/creational_singleton.js       | 4 +++-
 5 files changed, 17 insertions(+), 5 deletions(-)

diff --git a/src/static/patterns/creational_abstractFactory.js b/src/static/patterns/creational_abstractFactory.js
index d34604c..d9d9f16 100644
--- a/src/static/patterns/creational_abstractFactory.js
+++ b/src/static/patterns/creational_abstractFactory.js
@@ -2,7 +2,10 @@ const ABSTRACT_FACTORY = {
   id: 'abstract_factory',
   name: 'Abstract Factory',
   type: 'creational',
-  hint: 'groups object factories that have a common theme',
+  hint: 'Creates an instance of several families of classes',
+  description: `Rather than building a concrete object, it’s building a family of
+    related or dependent objects without specifying concrete class.`,
+  use: `system should be independent of how what it is producing is structured or represented`,
   codeES5: `function droidProducer(kind) {
   if (kind === 'battle') return battleDroidPattern;
   return pilotDroidPattern;
diff --git a/src/static/patterns/creational_builder.js b/src/static/patterns/creational_builder.js
index aa805bc..80f5a15 100644
--- a/src/static/patterns/creational_builder.js
+++ b/src/static/patterns/creational_builder.js
@@ -2,7 +2,10 @@ const BUILDER = {
   id: 'builder',
   name: 'Builder',
   type: 'creational',
-  hint: 'constructs complex objects by separating construction and representation',
+  hint: 'Separates object construction from its representation',
+  description: `Separate how object is created from its representation,
+    so the same process of creation can generate different representations.`,
+  use: `algorithm of creation is independent of the parts of the object`,
   codeES5: `function Request() {
   this.url = '';
   this.method = '';
diff --git a/src/static/patterns/creational_factory.js b/src/static/patterns/creational_factory.js
index 9f9c2db..6c46226 100644
--- a/src/static/patterns/creational_factory.js
+++ b/src/static/patterns/creational_factory.js
@@ -2,7 +2,9 @@ const FACTORY = {
   id: 'factory',
   name: 'Factory',
   type: 'creational',
-  hint: 'creates objects without specifying the exact class to create',
+  hint: 'Creates an instance of several derived classes',
+  description: `Gives an interface to build an object but let subclasses to decide which class to instantiate.`,
+  use: `a class wants its subclasses to decide which object to create`,
   codeES5: `function teslaPattern(type) {
   if (type === 'ModelX') return new Tesla(type, 108000, 300);
   if (type === 'ModelS') return new Tesla(type, 111000, 320);
diff --git a/src/static/patterns/creational_prototype.js b/src/static/patterns/creational_prototype.js
index b3e2c2d..229905b 100644
--- a/src/static/patterns/creational_prototype.js
+++ b/src/static/patterns/creational_prototype.js
@@ -2,7 +2,9 @@ const PROTOTYPE = {
   id: 'prototype',
   name: 'Prototype',
   type: 'creational',
-  hint: 'creates objects by cloning an existing object',
+  hint: 'A fully initialized instance to be copied or cloned',
+  description: `Create objects by copying prototypical instance of them.`,
+  use: `classes to instantiate are available only in runtime`,
   codeES5: `function Sheep(name, weight) {
   this.name = name;
   this.weight = weight;
diff --git a/src/static/patterns/creational_singleton.js b/src/static/patterns/creational_singleton.js
index b4aeaa8..d48ad30 100644
--- a/src/static/patterns/creational_singleton.js
+++ b/src/static/patterns/creational_singleton.js
@@ -2,7 +2,9 @@ const SINGLETON = {
   id: 'singleton',
   name: 'Singleton',
   type: 'creational',
-  hint: 'restricts object creation for a class to only one instance',
+  hint: 'A class of which only a single instance can exist',
+  description: `Ensures that a class has only one instance and gives global access to it.`,
+  use: `there must by only one instance of a class`,
   codeES5: `function Person() {
   if (typeof Person.instance === 'object') return Person.instance;
 

From 4dd1307997e7b5ade480a2139609a9667bd1612e Mon Sep 17 00:00:00 2001
From: Zoltan Toth <contact@zoltantoth.com>
Date: Fri, 15 Mar 2019 09:22:44 -0400
Subject: [PATCH 2/4] Update patterns details

---
 src/static/patterns/behavioral_chainOfResponsibility.js | 5 ++++-
 src/static/patterns/behavioral_command.js               | 6 +++++-
 src/static/patterns/behavioral_interpreter.js           | 6 +++++-
 src/static/patterns/behavioral_iterator.js              | 6 ++++--
 src/static/patterns/behavioral_mediator.js              | 7 +++++--
 src/static/patterns/behavioral_memento.js               | 5 ++++-
 src/static/patterns/behavioral_observer.js              | 5 ++++-
 src/static/patterns/behavioral_state.js                 | 5 ++++-
 src/static/patterns/behavioral_strategy.js              | 6 +++++-
 src/static/patterns/behavioral_template.js              | 6 ++++--
 src/static/patterns/behavioral_visitor.js               | 7 +++++--
 src/static/patterns/creational_abstractFactory.js       | 6 +++---
 src/static/patterns/creational_builder.js               | 6 +++---
 src/static/patterns/creational_factory.js               | 5 +++--
 src/static/patterns/creational_prototype.js             | 5 +++--
 src/static/patterns/creational_singleton.js             | 4 ++--
 src/static/patterns/structural_adapter.js               | 6 ++++--
 src/static/patterns/structural_bridge.js                | 5 ++++-
 src/static/patterns/structural_composite.js             | 5 ++++-
 src/static/patterns/structural_decorator.js             | 5 ++++-
 src/static/patterns/structural_facade.js                | 5 ++++-
 src/static/patterns/structural_flyweight.js             | 4 +++-
 src/static/patterns/structural_proxy.js                 | 5 +++--
 23 files changed, 89 insertions(+), 36 deletions(-)

diff --git a/src/static/patterns/behavioral_chainOfResponsibility.js b/src/static/patterns/behavioral_chainOfResponsibility.js
index c5772b4..bca669e 100644
--- a/src/static/patterns/behavioral_chainOfResponsibility.js
+++ b/src/static/patterns/behavioral_chainOfResponsibility.js
@@ -2,7 +2,10 @@ const CHAIN_OF_RESPONSIBILITY = {
   id: 'chain_of_responsibility',
   name: 'Chain of Responsibility',
   type: 'behavioral',
-  hint: 'delegates commands to a chain of processing objects',
+  hint: 'A way of passing a request between a chain of objects',
+  definition: `Avoid coupling the sender of a request to its receiver by giving more than one object a chance to
+    handle the request. Chain the receiving objects and pass the request along the chain until an object handles it.`,
+  when: 'more than one object can handle a request and that information is known in runtime',
   codeES5: `function ShoppingCart() {
   this.products = [];
 
diff --git a/src/static/patterns/behavioral_command.js b/src/static/patterns/behavioral_command.js
index 2a68d23..1382782 100644
--- a/src/static/patterns/behavioral_command.js
+++ b/src/static/patterns/behavioral_command.js
@@ -2,7 +2,11 @@ const COMMAND = {
   id: 'command',
   name: 'Command',
   type: 'behavioral',
-  hint: 'creates objects which encapsulate actions and parameters',
+  hint: 'Encapsulate a command request as an object',
+  definition: `Encapsulate a request as an object, thereby letting you parameterize clients with different requests,
+    queue or log requests, and support undoable operations.`,
+  when:
+    'you have a queue of requests to handle or you want to log them. Also when you want to have an «undo» action',
   codeES5: `function Cockpit(instruction) {
   this.instruction = instruction;
 }
diff --git a/src/static/patterns/behavioral_interpreter.js b/src/static/patterns/behavioral_interpreter.js
index 734c99c..f1b5ae9 100644
--- a/src/static/patterns/behavioral_interpreter.js
+++ b/src/static/patterns/behavioral_interpreter.js
@@ -2,7 +2,11 @@ const INTERPRETER = {
   id: 'interpteter',
   name: 'Interpreter',
   type: 'behavioral',
-  hint: 'implements a specialized language',
+  hint: 'A way to include language elements in a program',
+  definition: `Given a language, define a representation for its grammar along with an interpreter that
+    uses the representation to interpret sentences in the language.`,
+  when:
+    'you want to interpret given language and you can represent statements as an abstract syntax trees',
   codeES5: `function Sum(left, right) {
   this.left = left;
   this.right = right;
diff --git a/src/static/patterns/behavioral_iterator.js b/src/static/patterns/behavioral_iterator.js
index 6f91d3c..0267fe2 100644
--- a/src/static/patterns/behavioral_iterator.js
+++ b/src/static/patterns/behavioral_iterator.js
@@ -2,8 +2,10 @@ const ITERATOR = {
   id: 'iterator',
   name: 'Iterator',
   type: 'behavioral',
-  hint:
-    'accesses the elements of an object sequentially without exposing its underlying representation',
+  hint: 'Sequentially access the elements of a collection',
+  definition: `Provide a way to access the elements of an aggregate object sequentially
+    without exposing its underlying representation.`,
+  when: "you want to access object's content without knowing how it is internally represented",
   codeES5: `function Pattern(el) {
   this.index = 0;
   this.elements = el;
diff --git a/src/static/patterns/behavioral_mediator.js b/src/static/patterns/behavioral_mediator.js
index c1914b3..f5e460d 100644
--- a/src/static/patterns/behavioral_mediator.js
+++ b/src/static/patterns/behavioral_mediator.js
@@ -2,8 +2,11 @@ const MEDIATOR = {
   id: 'mediator',
   name: 'Mediator',
   type: 'behavioral',
-  hint:
-    'allows loose coupling between classes by being the only class that has detailed knowledge of their methods',
+  hint: 'Defines simplified communication between classes',
+  definition: `Define an object that encapsulates how a set of objects interact.
+    Mediator promotes loose coupling by keeping objects from referring to each other explicitly,
+    and it lets you vary their interaction independently.`,
+  when: 'a set of objects communicate in structured but complex ways',
   codeES5: `function TrafficTower() {
   this.airplanes = [];
 }
diff --git a/src/static/patterns/behavioral_memento.js b/src/static/patterns/behavioral_memento.js
index d59898b..f2f8bc7 100644
--- a/src/static/patterns/behavioral_memento.js
+++ b/src/static/patterns/behavioral_memento.js
@@ -2,7 +2,10 @@ const MEMENTO = {
   id: 'memento',
   name: 'Memento',
   type: 'behavioral',
-  hint: 'provides the ability to restore an object to its previous state',
+  hint: "Capture and restore an object's internal state",
+  definition: `Without violating encapsulation, capture and externalize an object's internal state
+    so that the object can be restored to this state later.`,
+  when: 'you need to take a snapshot of an object',
   codeES5: `function Pattern(value) {
   this.value = value;
 }
diff --git a/src/static/patterns/behavioral_observer.js b/src/static/patterns/behavioral_observer.js
index ff95a23..2d29fd5 100644
--- a/src/static/patterns/behavioral_observer.js
+++ b/src/static/patterns/behavioral_observer.js
@@ -2,7 +2,10 @@ const OBSERVER = {
   id: 'observer',
   name: 'Observer',
   type: 'behavioral',
-  hint: 'is a publish/subscribe pattern which allows a number of observer objects to see an event',
+  hint: 'A way of notifying change to a number of classes',
+  definition: `Define a one-to-many dependency between objects so that when one object changes state,
+    all its dependents are notified and updated automatically.`,
+  when: 'a change to one object requires changing others',
   codeES5: `function Product() {
   this.price = 0;
   this.actions = [];
diff --git a/src/static/patterns/behavioral_state.js b/src/static/patterns/behavioral_state.js
index 8ac4e76..46b956e 100644
--- a/src/static/patterns/behavioral_state.js
+++ b/src/static/patterns/behavioral_state.js
@@ -2,7 +2,10 @@ const STATE = {
   id: 'state',
   name: 'State',
   type: 'behavioral',
-  hint: 'allows an object to alter its behavior when its internal state changes',
+  hint: "Alter an object's behavior when its state changes",
+  definition: `Allow an object to alter its behavior when its internal state changes.
+    The object will appear to change its class.`,
+  when: `the object's behaviour depends on its state and its behaviour changes in run-time depends on that state`,
   codeES5: `function Order() {
   this.pattern = new WaitingForPayment();
 
diff --git a/src/static/patterns/behavioral_strategy.js b/src/static/patterns/behavioral_strategy.js
index a3f6f7f..cc8940b 100644
--- a/src/static/patterns/behavioral_strategy.js
+++ b/src/static/patterns/behavioral_strategy.js
@@ -2,7 +2,11 @@ const STRATEGY = {
   id: 'strategy',
   name: 'Strategy',
   type: 'behavioral',
-  hint: 'allows one of a family of algorithms to be selected on-the-fly at runtime',
+  hint: 'Encapsulates an algorithm inside a class',
+  definition: `Define a family of algorithms, encapsulate each one, and make them interchangeable.
+    Strategy lets the algorithm vary independently from clients that use it.`,
+  when: `you have many classes that differ in their behaviour.
+    Strategies allow to configure a class with one of many behaviours`,
   codeES5: `function ShoppingCart(discount) {
   this.discount = discount;
   this.amount = 0;
diff --git a/src/static/patterns/behavioral_template.js b/src/static/patterns/behavioral_template.js
index 1ad0020..e4ebcb0 100644
--- a/src/static/patterns/behavioral_template.js
+++ b/src/static/patterns/behavioral_template.js
@@ -2,8 +2,10 @@ const TEMPLATE = {
   id: 'template',
   name: 'Template',
   type: 'behavioral',
-  hint:
-    'defines the skeleton of an algorithm as an abstract class, allowing its subclasses to provide concrete behavior',
+  hint: 'Defer the exact steps of an algorithm to a subclass',
+  definition: `Define the skeleton of an algorithm in an operation, deferring some steps to subclasses.
+    Template Method lets subclasses redefine certain steps of an algorithm without changing the algorithm's structure.`,
+  when: `you have to define steps of the algorithm once and let subclasses to implement its behaviour`,
   codeES5: `function Tax() {}
 
 Tax.prototype.calc = function(value) {
diff --git a/src/static/patterns/behavioral_visitor.js b/src/static/patterns/behavioral_visitor.js
index d7e4a49..44ed1cd 100644
--- a/src/static/patterns/behavioral_visitor.js
+++ b/src/static/patterns/behavioral_visitor.js
@@ -2,8 +2,11 @@ const VISITOR = {
   id: 'visitor',
   name: 'Visitor',
   type: 'behavioral',
-  hint:
-    'separates an algorithm from an object structure by moving the hierarchy of methods into one object',
+  hint: 'Defines a new operation to a class without change',
+  definition: `Represent an operation to be performed on the elements of an object structure.
+    Visitor lets you define a new operation without changing the classes of the elements on which it operates.`,
+  when: `an object structure includes many classes and you want to perform an operations
+    on the elements of that structure that depend on their classes`,
   codeES5: `function bonusPattern(employee) {
   if (employee instanceof Manager) employee.bonus = employee.salary * 2;
   if (employee instanceof Developer) employee.bonus = employee.salary;
diff --git a/src/static/patterns/creational_abstractFactory.js b/src/static/patterns/creational_abstractFactory.js
index d9d9f16..96ceaba 100644
--- a/src/static/patterns/creational_abstractFactory.js
+++ b/src/static/patterns/creational_abstractFactory.js
@@ -3,9 +3,9 @@ const ABSTRACT_FACTORY = {
   name: 'Abstract Factory',
   type: 'creational',
   hint: 'Creates an instance of several families of classes',
-  description: `Rather than building a concrete object, it’s building a family of
-    related or dependent objects without specifying concrete class.`,
-  use: `system should be independent of how what it is producing is structured or represented`,
+  definition: `Provide an interface for creating families of related or dependent objects
+    without specifying their concrete classes.`,
+  when: 'system should be independent of how what it is producing is structured or represented',
   codeES5: `function droidProducer(kind) {
   if (kind === 'battle') return battleDroidPattern;
   return pilotDroidPattern;
diff --git a/src/static/patterns/creational_builder.js b/src/static/patterns/creational_builder.js
index 80f5a15..1cc900b 100644
--- a/src/static/patterns/creational_builder.js
+++ b/src/static/patterns/creational_builder.js
@@ -3,9 +3,9 @@ const BUILDER = {
   name: 'Builder',
   type: 'creational',
   hint: 'Separates object construction from its representation',
-  description: `Separate how object is created from its representation,
-    so the same process of creation can generate different representations.`,
-  use: `algorithm of creation is independent of the parts of the object`,
+  definition: `Separate the construction of a complex object from its representation
+    so that the same construction process can create different representations.`,
+  when: 'algorithm of creation is independent of the parts of the object',
   codeES5: `function Request() {
   this.url = '';
   this.method = '';
diff --git a/src/static/patterns/creational_factory.js b/src/static/patterns/creational_factory.js
index 6c46226..7424b11 100644
--- a/src/static/patterns/creational_factory.js
+++ b/src/static/patterns/creational_factory.js
@@ -3,8 +3,9 @@ const FACTORY = {
   name: 'Factory',
   type: 'creational',
   hint: 'Creates an instance of several derived classes',
-  description: `Gives an interface to build an object but let subclasses to decide which class to instantiate.`,
-  use: `a class wants its subclasses to decide which object to create`,
+  definition: `Define an interface for creating an object, but let subclasses decide
+    which class to instantiate. Factory Method lets a class defer instantiation to subclasses.`,
+  when: `a class wants its subclasses to decide which object to create`,
   codeES5: `function teslaPattern(type) {
   if (type === 'ModelX') return new Tesla(type, 108000, 300);
   if (type === 'ModelS') return new Tesla(type, 111000, 320);
diff --git a/src/static/patterns/creational_prototype.js b/src/static/patterns/creational_prototype.js
index 229905b..dbb66cf 100644
--- a/src/static/patterns/creational_prototype.js
+++ b/src/static/patterns/creational_prototype.js
@@ -3,8 +3,9 @@ const PROTOTYPE = {
   name: 'Prototype',
   type: 'creational',
   hint: 'A fully initialized instance to be copied or cloned',
-  description: `Create objects by copying prototypical instance of them.`,
-  use: `classes to instantiate are available only in runtime`,
+  definition: `Specify the kind of objects to create using a prototypical instance,
+    and create new objects by copying this prototype.`,
+  when: 'classes to instantiate are available only in runtime',
   codeES5: `function Sheep(name, weight) {
   this.name = name;
   this.weight = weight;
diff --git a/src/static/patterns/creational_singleton.js b/src/static/patterns/creational_singleton.js
index d48ad30..7bd9d2c 100644
--- a/src/static/patterns/creational_singleton.js
+++ b/src/static/patterns/creational_singleton.js
@@ -3,8 +3,8 @@ const SINGLETON = {
   name: 'Singleton',
   type: 'creational',
   hint: 'A class of which only a single instance can exist',
-  description: `Ensures that a class has only one instance and gives global access to it.`,
-  use: `there must by only one instance of a class`,
+  definition: 'Ensure a class has only one instance and provide a global point of access to it.',
+  when: 'there must by only one instance of a class',
   codeES5: `function Person() {
   if (typeof Person.instance === 'object') return Person.instance;
 
diff --git a/src/static/patterns/structural_adapter.js b/src/static/patterns/structural_adapter.js
index 6ff8842..721ed2e 100644
--- a/src/static/patterns/structural_adapter.js
+++ b/src/static/patterns/structural_adapter.js
@@ -2,8 +2,10 @@ const ADAPTER = {
   id: 'adapter',
   name: 'Adapter',
   type: 'structural',
-  hint: `allows classes with incompatible interfaces to work together by wrapping
-  its own interface around that of an already existing class`,
+  hint: `Match interfaces of different classes`,
+  definition: `Convert the interface of a class into another interface clients expect.
+    Adapter lets classes work together that couldn't otherwise because of incompatible interfaces.`,
+  when: `you want to use existing class but its interface does not match the one you need`,
   codeES5: `function Soldier(lvl) {
   this.lvl = lvl;
 }
diff --git a/src/static/patterns/structural_bridge.js b/src/static/patterns/structural_bridge.js
index 2e07900..95eb435 100644
--- a/src/static/patterns/structural_bridge.js
+++ b/src/static/patterns/structural_bridge.js
@@ -2,7 +2,10 @@ const BRIDGE = {
   id: 'bridge',
   name: 'Bridge',
   type: 'structural',
-  hint: 'decouples an abstraction from its implementation so that the two can vary independently',
+  hint: 'Separates an object’s interface from its implementation',
+  definition: `Decouple an abstraction from its implementation so that the two can vary independently.`,
+  when: `you want to avoid binding between abstraction and its implementation if, for example,
+    each of them must be selected in runtime`,
   codeES5: `function EpsonPrinter(ink) {
   this.ink = ink();
 }
diff --git a/src/static/patterns/structural_composite.js b/src/static/patterns/structural_composite.js
index 1cf4215..5c54ebe 100644
--- a/src/static/patterns/structural_composite.js
+++ b/src/static/patterns/structural_composite.js
@@ -2,7 +2,10 @@ const COMPOSITE = {
   id: 'composite',
   name: 'Composite',
   type: 'structural',
-  hint: 'composes zero-or-more similar objects so that they can be manipulated as one object',
+  hint: 'A tree structure of simple and composite objects',
+  definition: `Compose objects into tree structures to represent part-whole hierarchies.
+    Composite lets clients treat individual objects and compositions of objects uniformly.`,
+  when: `you want to represent hierarchies of objects`,
   codeES5: `function EquipmentPattern(name) {
   this.equipments = [];
   this.name = name;
diff --git a/src/static/patterns/structural_decorator.js b/src/static/patterns/structural_decorator.js
index c492e7c..300dc93 100644
--- a/src/static/patterns/structural_decorator.js
+++ b/src/static/patterns/structural_decorator.js
@@ -2,7 +2,10 @@ const DECORATOR = {
   id: 'decorator',
   name: 'Decorator',
   type: 'structural',
-  hint: 'dynamically adds/overrides behaviour in an existing method of an object',
+  hint: 'Add responsibilities to objects dynamically',
+  definition: `Attach additional responsibilities to an object dynamically.
+    Decorators provide a flexible alternative to subclassing for extending functionality.`,
+  when: `you want to add extensions to an object in runtime without affecting other objects`,
   codeES5: `function Pasta() {
   this.price = 0;
 }
diff --git a/src/static/patterns/structural_facade.js b/src/static/patterns/structural_facade.js
index 809105d..d1cc6c3 100644
--- a/src/static/patterns/structural_facade.js
+++ b/src/static/patterns/structural_facade.js
@@ -2,7 +2,10 @@ const FACADE = {
   id: 'facade',
   name: 'Facade',
   type: 'structural',
-  hint: 'provides a simplified interface to a large body of code',
+  hint: 'A single class that represents an entire subsystem',
+  definition: `Provide a unified interface to a set of interfaces in a subsystem.
+    Facade defines a higher-level interface that makes the subsystem easier to use.`,
+  when: `you want to provide a simple interface to a complex subsystem`,
   codeES5: `var shopPattern = {
   calc: function(price) {
     price = discount(price);
diff --git a/src/static/patterns/structural_flyweight.js b/src/static/patterns/structural_flyweight.js
index f547607..a96e383 100644
--- a/src/static/patterns/structural_flyweight.js
+++ b/src/static/patterns/structural_flyweight.js
@@ -2,7 +2,9 @@ const FLYWEIGHT = {
   id: 'flyweight',
   name: 'Flyweight',
   type: 'structural',
-  hint: 'reduces the cost of creating and manipulating a large number of similar objects',
+  hint: 'A fine-grained instance used for efficient sharing',
+  definition: `Use sharing to support large numbers of fine-grained objects efficiently.`,
+  when: `an application uses a lot of small objects and their storing is expensive or their identity is not important`,
   codeES5: `function Color(name) {
   this.name = name;
 }
diff --git a/src/static/patterns/structural_proxy.js b/src/static/patterns/structural_proxy.js
index c1831b7..73095b9 100644
--- a/src/static/patterns/structural_proxy.js
+++ b/src/static/patterns/structural_proxy.js
@@ -2,8 +2,9 @@ const PROXY = {
   id: 'proxy',
   name: 'Proxy',
   type: 'structural',
-  hint:
-    'provides a placeholder for another object to control access, reduce cost, and reduce complexity',
+  hint: 'An object representing another object',
+  definition: `Provide a surrogate or placeholder for another object to control access to it.`,
+  when: ``,
   codeES5: `function Car() {
   this.drive = function() {
     return 'driving';

From 37fa6692de082b149b7464caca14135a7937bc06 Mon Sep 17 00:00:00 2001
From: Zoltan Toth <contact@zoltantoth.com>
Date: Fri, 15 Mar 2019 09:33:32 -0400
Subject: [PATCH 3/4] Update Pattern component to reflect all the info

---
 src/components/Pattern.jsx | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/src/components/Pattern.jsx b/src/components/Pattern.jsx
index 12429e2..59940f8 100644
--- a/src/components/Pattern.jsx
+++ b/src/components/Pattern.jsx
@@ -73,9 +73,15 @@ class Pattern extends React.Component {
               <Type>{pattern.type} pattern</Type>
             </p>
             <p>
-              <SubHeader>Description:</SubHeader>
-              {`This pattern ${pattern.hint}.`}
+              <SubHeader>Definition:</SubHeader>
+              {pattern.definition}
             </p>
+            {pattern.when && (
+              <p>
+                <SubHeader>Use when&hellip;</SubHeader>
+                &hellip;{pattern.when}.
+              </p>
+            )}
 
             <h3>ES5</h3>
             <SyntaxHighlighter language="javascript" style={style}>

From 88b39e16e484f8d7fac46f2247c7a7e2d4e63a1d Mon Sep 17 00:00:00 2001
From: Zoltan Toth <contact@zoltantoth.com>
Date: Fri, 15 Mar 2019 09:45:25 -0400
Subject: [PATCH 4/4] Update snapshots

---
 .../components/__snapshots__/Pattern.test.js.snap  | 14 ++++++++++++--
 .../pages/__snapshots__/Patterns.test.js.snap      | 14 ++++++++++++--
 2 files changed, 24 insertions(+), 4 deletions(-)

diff --git a/__tests__/components/__snapshots__/Pattern.test.js.snap b/__tests__/components/__snapshots__/Pattern.test.js.snap
index 81a3e6e..681190e 100644
--- a/__tests__/components/__snapshots__/Pattern.test.js.snap
+++ b/__tests__/components/__snapshots__/Pattern.test.js.snap
@@ -59,9 +59,19 @@ exports[`REFERENCE - Pattern component renders the individual pattern (Singleton
     <span
       className="c2"
     >
-      Description:
+      Definition:
     </span>
-    This pattern restricts object creation for a class to only one instance.
+    Ensure a class has only one instance and provide a global point of access to it.
+  </p>
+  <p>
+    <span
+      className="c2"
+    >
+      Use when…
+    </span>
+    …
+    there must by only one instance of a class
+    .
   </p>
   <h3>
     ES5
diff --git a/__tests__/pages/__snapshots__/Patterns.test.js.snap b/__tests__/pages/__snapshots__/Patterns.test.js.snap
index 034fc87..b4570ec 100644
--- a/__tests__/pages/__snapshots__/Patterns.test.js.snap
+++ b/__tests__/pages/__snapshots__/Patterns.test.js.snap
@@ -295,9 +295,19 @@ exports[`Patterns page renders the individual Pattern (Singleton) info 1`] = `
     <span
       className="c2"
     >
-      Description:
+      Definition:
     </span>
-    This pattern restricts object creation for a class to only one instance.
+    Ensure a class has only one instance and provide a global point of access to it.
+  </p>
+  <p>
+    <span
+      className="c2"
+    >
+      Use when…
+    </span>
+    …
+    there must by only one instance of a class
+    .
   </p>
   <h3>
     ES5