Skip to content

Commit a99e947

Browse files
committed
Update Periphery
1 parent e443e6d commit a99e947

File tree

1 file changed

+22
-4
lines changed

1 file changed

+22
-4
lines changed

README.md

Lines changed: 22 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -699,10 +699,28 @@ start working with the Periphery. By cleaning up the periphery, you'll often
699699
find that the core problem becomes clearer and more approachable.
700700

701701
A 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

707725
Another word for Periphery is Background, see also
708726
[Deconcentation of Attention](http://deconcentration-of-attention.com/).

0 commit comments

Comments
 (0)