@@ -699,10 +699,28 @@ start working with the Periphery. By cleaning up the periphery, you'll often
699699find that the core problem becomes clearer and more approachable.
700700
701701A good example is legacy code: issues in the periphery, such as poor variable
702- names, incorrect class responsibilities (even those distant from your immediate
703- problem), or a disorganized folder structure, may seem irrelevant to the core
704- issue. However, they still contribute to the cognitive overload. Fixing them
705- will help clear the path for your actual work.
702+ names, bad code formatting, or a disorganized folder structure, may seem
703+ irrelevant to the core issue. However, they still contribute to the cognitive
704+ overload.
705+
706+ Unclear or messy periphery can be a constant attention sink. It leads to
707+ mistakes, confusion, and delays, especially when teams don't take the time to
708+ fix it. Recognizing periphery issues and acting on them is a skill in itself. It
709+ helps to keep your mental state clear and reduces unnecessary mental work.
710+
711+ Some examples of periphery issues:
712+
713+ - ** Naming** . Folders, files, documents, tools, and conventions. Poor or
714+ inconsistent naming alone can create significant noise.
715+
716+ - ** Code formatting** . Inconsistent or sloppy formatting adds friction for
717+ everyone.
718+
719+ - ** Structure** . Disorganized codebases or documentation make it hard to find
720+ and understand things. See also: "Encyclopedic Document".
721+
722+ - ** Responsibilities** . Incorrect or unclear class and component
723+ responsibilities, even far from your immediate task, add to cognitive load.
706724
707725Another word for Periphery is Background, see also
708726[ Deconcentation of Attention] ( http://deconcentration-of-attention.com/ ) .
0 commit comments