Add description and use fields to creational patterns

zoltantothcom · zoltantothcom · commit ca135d8abf81 · 2019-03-14T10:48:32.000-04:00
diff --git 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
@@ -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
@@ -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
@@ -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
@@ -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;
 
