Fixed issues in comments.

neochief · neochief · commit 2e945083ecdf · 2019-02-28T17:00:52.000+02:00
diff --git a/src/AbstractFactory/Conceptual/main.py b/src/AbstractFactory/Conceptual/main.py
@@ -1,8 +1,8 @@
 """
 EN: Abstract Factory Design Pattern
 
-Intent: Provide an interface for creating families of related or dependent
-objects without specifying their concrete classes.
+Intent: Lets you produce families of related objects without specifying their
+concrete classes.
 
 RU: Паттерн Абстрактная Фабрика
 
diff --git a/src/Adapter/Conceptual/main.py b/src/Adapter/Conceptual/main.py
@@ -1,14 +1,12 @@
 """
 EN: Adapter Design Pattern
 
-Intent: Convert the interface of a class into the interface clients expect.
-Adapter lets classes work together where they otherwise couldn't, due to
-incompatible interfaces.
+Intent: Provides a unified interface that allows objects with incompatible
+interfaces to collaborate.
 
 RU: Паттерн Адаптер
 
-Назначение: Преобразует интерфейс класса в интерфейс, ожидаемый клиентами.
-Адаптер позволяет классам с несовместимыми интерфейсами работать вместе.
+Назначение: Позволяет объектам с несовместимыми интерфейсами работать вместе.
 """
 
 
diff --git a/src/Bridge/Conceptual/main.py b/src/Bridge/Conceptual/main.py
@@ -1,8 +1,9 @@
 """
 EN: Bridge Design Pattern
 
-Intent: Decouple an abstraction from its implementation so that the two can vary
-independently.
+Intent: Lets you split a large class or a set of closely related classes into
+two separate hierarchies—abstraction and implementation—which can be developed
+independently of each other.
 
               A
            /     \                        A         N
@@ -12,8 +13,8 @@
 
 RU: Паттерн Мост
 
-Назначение: Разделяет абстракцию и реализацию, что позволяет изменять их
-независимо друг от друга.
+Назначение: Разделяет один или несколько классов на две отдельные иерархии —
+абстракцию и реализацию, позволяя изменять их независимо друг от друга.
 
               A
            /     \                        A         N
diff --git a/src/Builder/Conceptual/main.py b/src/Builder/Conceptual/main.py
@@ -1,13 +1,15 @@
 """
 EN: Builder Design Pattern
 
-Intent: Separate the construction of a complex object from its representation so
-that the same construction process can create different representations.
+Intent: Lets you construct complex objects step by step. The pattern allows you
+to produce different types and representations of an object using the same
+construction code.
 
 RU: Паттерн Строитель
 
-Назначение: Отделяет построение сложного объекта от его представления так, что
-один и тот же процесс построения может создавать разные представления объекта.
+Назначение: Позволяет создавать сложные объекты пошагово. Строитель даёт
+возможность использовать один и тот же код строительства для получения разных
+представлений объектов.
 """
 
 
diff --git a/src/ChainOfResponsibility/Conceptual/main.py b/src/ChainOfResponsibility/Conceptual/main.py
@@ -1,16 +1,15 @@
 """
 EN: Chain of Responsibility Design Pattern
 
-Intent: Avoid coupling a sender of a request to its receiver by giving more than
-one object a chance to handle the request. Chain the receiving objects and then
-pass the request through the chain until some receiver handles it.
+Intent: Lets you pass requests along a chain of handlers. Upon receiving a
+request, each handler decides either to process the request or to pass it to the
+next handler in the chain.
 
 RU: Паттерн Цепочка обязанностей
 
-Назначение: Позволяет избежать привязки отправителя запроса к его получателю,
-предоставляя возможность обработать запрос нескольким объектам. Связывает в
-цепочку объекты-получатели, а затем передаёт запрос по цепочке, пока некий
-получатель не обработает его.
+Назначение: Позволяет передавать запросы последовательно по цепочке
+обработчиков. Каждый последующий обработчик решает, может ли он обработать
+запрос сам и стоит ли передавать запрос дальше по цепи.
 """
 
 from __future__ import annotations
diff --git a/src/Command/Conceptual/main.py b/src/Command/Conceptual/main.py
@@ -1,14 +1,15 @@
 """
 EN: Command Design Pattern
 
-Intent: Encapsulate a request as an object, thereby letting you parameterize
-clients with different requests (e.g. queue or log requests) and support
-undoable operations.
+Intent: Turns a request into a stand-alone object that contains all information
+about the request. This transformation lets you parameterize methods with
+different requests, delay or queue a request's execution, and support undoable
+operations.
 
 RU: Паттерн Команда
 
-Назначение: Инкапсулирует запрос как объект, позволяя тем самым параметризовать
-клиентов с различными запросами (например, запросами очереди или логирования) и
+Назначение: Превращает запросы в объекты, позволяя передавать их как аргументы
+при вызове методов, ставить запросы в очередь, логировать их, а также
 поддерживать отмену операций.
 """
 
diff --git a/src/Composite/Conceptual/main.py b/src/Composite/Conceptual/main.py
@@ -1,15 +1,13 @@
 """
 EN: Composite Design Pattern
 
-Intent: Compose objects into tree structures to represent part-whole
-hierarchies. Composite lets clients treat individual objects and compositions of
-objects uniformly.
+Intent: Lets you compose objects into tree structures and then work with these
+structures as if they were individual objects.
 
 RU: Паттерн Компоновщик
 
-Назначение: Объединяет объекты в древовидные структуры для представления
-иерархий часть-целое. Компоновщик позволяет клиентам обрабатывать отдельные
-объекты и группы объектов одинаковым образом.
+Назначение: Позволяет сгруппировать объекты в древовидную структуру, а затем
+работать с ними так, как будто это единичный объект.
 """
 
 
diff --git a/src/Decorator/Conceptual/main.py b/src/Decorator/Conceptual/main.py
@@ -1,14 +1,13 @@
 """
 EN: Decorator Design Pattern
 
-Intent: Attach additional responsibilities to an object dynamically. Decorators
-provide a flexible alternative to subclassing for extending functionality.
+Intent: Lets you attach new behaviors to objects by placing these objects inside
+special wrapper objects that contain the behaviors.
 
 RU: Паттерн Декоратор
 
-Назначение: Динамически подключает к объекту дополнительную функциональность.
-Декораторы предоставляют гибкую альтернативу практике создания подклассов для
-расширения функциональности.
+Назначение: Позволяет динамически добавлять объектам новую функциональность,
+оборачивая их в полезные «обёртки».
 """
 
 
diff --git a/src/Facade/Conceptual/main.py b/src/Facade/Conceptual/main.py
@@ -1,15 +1,13 @@
 """
 EN: Facade Design Pattern
 
-Intent: Provide a unified interface to a number of classes/interfaces of a
-complex subsystem. The Facade pattern defines a higher-level interface that
-makes the subsystem easier to use.
+Intent: Provides a simplified interface to a library, a framework, or any other
+complex set of classes.
 
 RU: Паттерн Фасад
 
-Назначение: Предоставляет единый интерфейс к ряду классов/интерфейсов сложной
-подсистемы. Паттерн Фасад определяет интерфейс более высокого уровня, который
-упрощает использование подсистемы.
+Назначение: Предоставляет простой интерфейс к сложной системе классов,
+библиотеке или фреймворку.
 """
 
 
diff --git a/src/FactoryMethod/Conceptual/main.py b/src/FactoryMethod/Conceptual/main.py
@@ -1,15 +1,13 @@
 """
 EN: Factory Method Design Pattern
 
-Intent: Define an interface for creating an object, but let subclasses decide
-which class to instantiate. Factory Method lets a class defer instantiation to
-subclasses.
+Intent: Provides an interface for creating objects in a superclass, but allows
+subclasses to alter the type of objects that will be created.
 
 RU: Паттерн Фабричный Метод
 
-Назначение: Определяет интерфейс для создания объекта, но позволяет подклассам
-решать, какого класса создавать экземпляр. Фабричный Метод позволяет классу
-делегировать создание экземпляра подклассам.
+Назначение: Определяет общий интерфейс для создания объектов в суперклассе,
+позволяя подклассам изменять тип создаваемых объектов.
 """
 
 
diff --git a/src/Flyweight/Conceptual/main.py b/src/Flyweight/Conceptual/main.py
@@ -1,15 +1,15 @@
 """
 EN: Flyweight Design Pattern
 
-Intent: Use sharing to fit more objects into the available amount of RAM by
-sharing common parts of the object state among multiple objects, instead of
-keeping the entire state in each object.
+Intent: Lets you fit more objects into the available amount of RAM by sharing
+common parts of state between multiple objects, instead of keeping all of the
+data in each object.
 
 RU: Паттерн Легковес
 
 Назначение: Позволяет вместить бóльшее количество объектов в отведённую
 оперативную память. Легковес экономит память, разделяя общее состояние объектов
-между ними, вместо хранения одинаковых данных в каждом объекте.
+между собой, вместо хранения одинаковых данных в каждом объекте.
 """
 
 
diff --git a/src/Iterator/Conceptual/main.py b/src/Iterator/Conceptual/main.py
@@ -1,13 +1,13 @@
 """
 EN: Iterator Design Pattern
 
-Intent: Provide a way to traverse the elements of an aggregate object without
-exposing its underlying representation.
+Intent: Lets you traverse elements of a collection without exposing its
+underlying representation (list, stack, tree, etc.).
 
 RU: Паттерн Итератор
 
-Назначение: Предоставляет возможность обходить элементы составного объекта, не
-раскрывая его внутреннего представления.
+Назначение: Даёт возможность последовательно обходить элементы составных
+объектов, не раскрывая их внутреннего представления.
 """
 
 
diff --git a/src/Mediator/Conceptual/main.py b/src/Mediator/Conceptual/main.py
@@ -1,16 +1,14 @@
 """
 EN: Mediator Design Pattern
 
-Intent: 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.
+Intent: Lets you reduce chaotic dependencies between objects. The pattern
+restricts direct communications between the objects and forces them to
+collaborate only via a mediator object.
 
 RU: Паттерн Посредник
 
-Назначение: Определяет объект, который инкапсулирует взаимодействие набора
-объектов. Посредник способствует слабой связанности, удерживая объекты от
-обращения друг к другу напрямую, и это позволяет вам менять их взаимодействие
-независимо.
+Назначение: Позволяет уменьшить связанность множества классов между собой,
+благодаря перемещению этих связей в один класс-посредник.
 """
 
 
diff --git a/src/Memento/Conceptual/main.py b/src/Memento/Conceptual/main.py
@@ -1,8 +1,8 @@
 """
 EN: Memento Design Pattern
 
-Intent: Capture and externalize an object's internal state so that the object
-can be restored to this state later, without violating encapsulation.
+Intent: Lets you save and restore the previous state of an object without
+revealing the details of its implementation.
 
 RU: Паттерн Снимок
 
diff --git a/src/Observer/Conceptual/main.py b/src/Observer/Conceptual/main.py
@@ -1,8 +1,8 @@
 """
 EN: Observer Design Pattern
 
-Intent: Define a one-to-many dependency between objects so that when one object
-changes state, all of its dependents are notified and updated automatically.
+Intent: Lets you define a subscription mechanism to notify multiple objects
+about any events that happen to the object they're observing.
 
 Note that there's a lot of different terms with similar meaning associated with
 this pattern. Just remember that the Subject is also called the Publisher and
@@ -11,9 +11,8 @@
 
 RU: Паттерн Наблюдатель
 
-Назначение: Устанавливает между объектами зависимость «один ко многим» таким
-образом, что когда изменяется состояние одного объекта, все зависимые от него
-объекты оповещаются и обновляются автоматически.
+Назначение: Создаёт механизм подписки, позволяющий одним объектам следить и
+реагировать на события, происходящие в других объектах.
 
 Обратите внимание, что существует множество различных терминов с похожими
 значениями, связанных с этим паттерном. Просто помните, что Субъекта также
diff --git a/src/Prototype/Conceptual/main.py b/src/Prototype/Conceptual/main.py
@@ -1,13 +1,13 @@
 """
 EN: Prototype Design Pattern
 
-Intent: Produce new objects by copying existing ones without compromising their
-internal structure.
+Intent: Lets you copy existing objects without making your code dependent on
+their classes.
 
 RU: Паттерн Прототип
 
-Назначение: Создаёт новые объекты, копируя существующие без нарушения их
-внутренней структуры.
+Назначение: Позволяет копировать объекты, не вдаваясь в подробности их
+реализации.
 """
 
 
diff --git a/src/Proxy/Conceptual/main.py b/src/Proxy/Conceptual/main.py
@@ -6,9 +6,9 @@
 
 RU: Паттерн Заместитель
 
-Назначение: Предоставляет заменитель или местозаполнитель для другого объекта,
-чтобы контролировать доступ к оригинальному объекту или добавлять другие
-обязанности.
+Назначение: Позволяет подставлять вместо реальных объектов специальные
+объекты-заменители. Эти объекты перехватывают вызовы к оригинальному объекту,
+позволяя сделать что-то до или после передачи вызова оригиналу.
 """
 
 
diff --git a/src/Singleton/Conceptual/NonThreadSafe/main.py b/src/Singleton/Conceptual/NonThreadSafe/main.py
@@ -1,13 +1,13 @@
 """
 EN: Singleton Design Pattern
 
-Intent: Ensure that a class has a single instance, and provide a global point of
-access to it.
+Intent: Lets you ensure that a class has only one instance, while providing a
+global access point to this instance.
 
 RU: Паттерн Одиночка
 
-Назначение: Гарантирует существование единственного экземпляра класса и
-предоставляет глобальную точку доступа к нему.
+Назначение: Гарантирует, что у класса есть только один экземпляр, и
+предоставляет к нему глобальную точку доступа.
 """
 
 
diff --git a/src/Singleton/Conceptual/ThreadSafe/main.py b/src/Singleton/Conceptual/ThreadSafe/main.py
@@ -1,13 +1,13 @@
 """
 EN: Singleton Design Pattern
 
-Intent: Ensure that a class has a single instance, and provide a global point of
-access to it.
+Intent: Lets you ensure that a class has only one instance, while providing a
+global access point to this instance.
 
 RU: Паттерн Одиночка
 
-Назначение: Гарантирует существование единственного экземпляра класса и
-предоставляет глобальную точку доступа к нему.
+Назначение: Гарантирует, что у класса есть только один экземпляр, и
+предоставляет к нему глобальную точку доступа.
 """
 
 
diff --git a/src/State/Conceptual/main.py b/src/State/Conceptual/main.py
@@ -1,13 +1,13 @@
 """
 EN: State Design Pattern
 
-Intent: Allow an object to alter its behavior when its internal state changes.
-The object will appear to change its class.
+Intent: Lets an object alter its behavior when its internal state changes. It
+appears as if the object changed its class.
 
 RU: Паттерн Состояние
 
-Назначение: Позволяет объекту менять поведение при изменении его внутреннего
-состояния. Со стороны может казаться, что объект меняет свой класс.
+Назначение: Позволяет объектам менять поведение в зависимости от своего
+состояния. Извне создаётся впечатление, что изменился класс объекта.
 """
 
 
diff --git a/src/Strategy/Conceptual/main.py b/src/Strategy/Conceptual/main.py
@@ -1,15 +1,14 @@
 """
 EN: Strategy Design Pattern
 
-Intent: Define a family of algorithms, encapsulate each one, and make them
-interchangeable. Strategy lets the algorithm vary independently from clients
-that use it.
+Intent: Lets you define a family of algorithms, put each of them into a separate
+class, and make their objects interchangeable.
 
 RU: Паттерн Стратегия
 
-Назначение: Определяет семейство алгоритмов, инкапсулирует каждый из них и
-делает взаимозаменяемыми. Стратегия позволяет изменять алгоритм независимо от
-клиентов, которые его используют.
+Назначение: Определяет семейство схожих алгоритмов и помещает каждый из них в
+собственный класс, после чего алгоритмы можно взаимозаменять прямо во время
+исполнения программы.
 """
 
 
diff --git a/src/TemplateMethod/Conceptual/main.py b/src/TemplateMethod/Conceptual/main.py
diff --git a/src/Visitor/Conceptual/main.py b/src/Visitor/Conceptual/main.py
