WIP

Author: tabuna

draft/006.md

@@ -0,0 +1,56 @@
+В индустрии программирования принято считать, что код должен быть самодокументируемым.
+Это значит, что имена переменных, методов и классов должны объяснять, что происходит — без комментариев, без документации, без менторов.
+
+Некоторые даже добавляют:
+
+> «Пусть имя будет длинным, это делает код понятнее».
+
+Нет. Не делает.
+Особенно если это имя — дымовая завеса над тем, что в коде нет ни логики, ни смысла.
+
+
+Рассмотрим наглядный пример, достойный быть высеченным в граните Legacy-кода:
+
+```php
+abstract class AbstractContextHandler implements ContextHandlerInterface
+{
+    use SemanticMapper;
+
+    public string $moduleNamespaceScopeIdentifier = 'reporting_contextualization_subsystem';
+
+    public function process(array $contextualizedComponentUnitPayloadArray): array
+    {
+        $moduleScopedResponseUnits = [];
+
+        foreach ($contextualizedComponentUnitPayloadArray as $contextBoundSemanticUnit) {
+            $moduleScopedResponseUnits[] = $this->transformComponentContextUnit($contextBoundSemanticUnit);
+        }
+
+        return $moduleScopedResponseUnits;
+    }
+
+    protected function transformComponentContextUnit($contextBoundSemanticUnit): array
+    {
+        return [
+            'encodedContextualPayloadFragment' => $this->map($contextBoundSemanticUnit),
+            'componentUnitIntegrityChecksum' => sha1(serialize($contextBoundSemanticUnit)),
+            'injectedContextualTagToken' => uniqid('module_ctx_unit_', true),
+            'operationalModuleDomain' => $this->moduleNamespaceScopeIdentifier,
+        ];
+    }
+}
+```
+
+Что делает этот класс? Не ясно.
+Что он обрабатывает? Какой «контекст»? Какой «модуль»? Что за «единицы компонентов»?
+
+Это типичный корпоративный анти-паттерн: взять простую задачу, обернуть её в кучу терминов, и сделать вид, что это архитектура.
+
+
+Если ты называешь переменную `injectedContextualTagToken`, ты не архитектор.
+Ты просто боишься назвать её `id`.
+
+
+
+Этот код невозможно понять. Не потому что он глупый.
+А потому что этот код никогда ничего конкретного не делал