Cognitive Load and Your Development Environment

Cognitive Load and Your Development Environment

Watch the talk in the live recording of MagnoliaJS Day 2.

There's lots of information out there about reducing cognitive load for users, but what about developers? Let's talk about Cognitive Load Theory, how some disabilities affect it, and designing a developer environment around it.

What Is Cognitive Load?

Cognitive Load is the amount of available memory and cognition (thinking) resources you have.

Cognitive Load is also used to describe the amount of memory and cognition resources a task requires.

Cognitive Overload is triggered by a task or tasks requiring more Cognitive Load than you can sustain.

zombie reaching towards you saying "more brains"

Memory and cognition are made up of many complex processes working together. You can only think about and remember so many things at one time. Many things affect how easy it is to get information through all the processes and stored in your memory. It may be how long you have to focus, the way information is presented to you, the amount of information, or the complexity of the information.

Things that reduce focus and energy reduce your available Cognitive Load. Lacking physical resources, like food, sleep, and shelter, makes it harder to think. There are fewer available resources to power your brain and you're probably focused on finding those things. Physical discomfort distracts you. If your office is too cold, you're going to use up some of your thinking power trying to find a way to warm up.

We know emotions affect our available Cognitive Load. Generally, we can assume negative emotions reduce available Cognitive Load, but the relationship is complex. Chronic stress definitely negatively affects available Cognitive Load. If you've had a bad day or a lot of really stressful days, you've probably noticed it's harder to think and focus.

Cognitive Load and Disabilities

Mental illness and disabilities can reduce available Cognitive Load. Some disabilities increase the Cognitive Load common tasks take. If we're aware of this, we can reframe information in a way that helps prevent Cognitive Overload.

Anxiety and Post-Traumatic Stress Disorder (PTSD) both keep the mind and body in a heightened state of stress that affects focus, information processing, and memory.

Chronic pain will take up some of your resources focusing on the pain and reduce your available memory overall.

A sensory processing disorder or learning disorder adds Cognitive Load to taking in information and processing it.

Cognitive disabilities stemming from physical injury to the brain or dysfunction of brain structure like Traumatic Brain Injury (TBI), Dementia, Alzheimer's, and Amnesia can have devastating effects on every part of the information storing process. The effects of a TBI depend on what part of the brain has been injured. It may be the language processing center is injured and the individual has to relearn language. If the part of the brain controlling executive function is injured, a TBI becomes an executive function disorder.

Executive function, our ability to plan, control our impulses, and direct our attention, also affects nearly every part of cognition and memory. Attention Deficit Hyperactivity Disorder (ADHD) is an executive function disorder. Those with ADHD often say they don't have a deficit of attention, they just can't direct their attention like those without ADHD. The brain is unable to filter out distractions and tries to pay attention to everything, resulting in frequent Cognitive Overload. Attention isn't sustained on information long enough to get it through the processes to store it in memory. Rather than an importance-based nervous system, those with ADHD have an interest-based nervous system. Introducing something they're naturally interested in, some challenge or competition, novelty, or urgency allows them to sustain attention and increase their available Cognitive Load. However, sustained attention can become hyperfocus. They struggle to direct their attention away from something that interests them. When sustained for long enough, this backfires and reduces Cognitive Load through fatigue, hunger, etc.

Those with Autism Spectrum Disorder (ASD) also struggle with frequent Cognitive Overload, and executive dysfunction is one of many theories as to why. We do know sensory information is not filtered out. As they take information in, it is difficult to discern what is the most important stimulus. There is also research suggesting that the amount of verbal information they can think about at one time is lower to start. However, much like ADHD, if information is communicated in a style that works for someone with Autism and sensory input is kept to a minimum, Cognitive Load can be reduced to a manageable level.

Applied Cognitive Load Theory

woman holding a brain in a bowl and chopsticks

Human Factors and Ergonomics investigates the way a human doing a task is affected by everything around them. Cognitive Ergonomics investigates the way the design of an interface matches the cognitive capabilities of users. Both seek to reduce errors, increase work quality, improve decision-making, and increase productivity. Both Human Factors and Cognitive Ergonomics would apply Cognitive Load Theory to something like the layout of a nuclear power plant control panel.

Instructional Design studies the way the design of learning materials affects the consumption of information by learners. This isn't limited to school. Instructional Designers also design training for employees. A large part of Instructional Design is studying how people absorb information, including Cognitive Load.

Studies from all three of these disciplines routinely inform User Experience (UX) and User Interface (UI) design. This is how a web developer may know how to reduce the cognitive load of a form for their users.

Instructional Design and Your Codebase

Instructional Designers have defined three ways to describe how difficult information is to process.

  • Intrinsic Cognitive Load is how difficult the concept is to understand.

  • Extraneous Cognitive Load is how difficult the presentation of the information is to understand.

  • Germane Cognitive Load is how much Cognitive Load is required to process the information and store it in memory.

We can use Instructional Design as a template for assessing the Cognitive Load required to learn a new codebase.

Code Climate, a tool that measures many things about your code base, includes a metric for the Intrinsic Cognitive Load of the codebase called Cognitive Complexity. It uses concepts defined by G. Ann Campbell in the white paper {Cognitive Complexity} a new way of measuring understandability. Points are assigned to lines of code that increase Cognitive Load through abstraction, nesting, etc. Often, this is referred to as readability.

The Extraneous Cognitive Load is how information about your codebase is presented. Do you have helpful documentation? This includes where your documentation is located - is it easily findable? Is it one long chunk of text or broken up by headings or even pages? Is it reference documentation or a guide?

The Germane Cognitive Load of your codebase is how difficult it is to understand the whole system. You can decrease the Cognitive Load required to understand it by diagramming out mental models and providing multiple ways to consume information about your codebase, including videos with captions.

Cognitive Load Theory and Your Development Environment

zombie standing in a grave and yawning

Beyond Your Computer

Your development environment extends beyond your computer. It is easier to code when your physical needs are met - food, water, sleep, and breaks. You have to take breaks. Just like a car, your brain can't run without fuel to burn.

Reduce Distractions

Reduce the amount of information you're taking in while trying to focus. This isn't limited to sounds - hiding windows you aren't actively using and turning off notifications can only help you. If your development server takes time to load, that increases the amount of Cognitive Load spent sustaining your attention on waiting for it to boot up. Without other things to look at, the Cognitive Load required to sustain attention decreases.

Reduce Context Switching

Reduce context switching as much as possible. It takes you longer to switch than you think, stresses you out, and prevents you from going deep on one topic. If you can, split up tasks so you can concentrate on one area for a period of time, take a break, and then context switch. Try task batching, day theming, or time blocking. As part of that, set times you'll respond to notifications and emails, so you don't have to always be paying attention to them.

Don’t Try to Remember Everything

Any tasks you need to remember to do in the future should be stored somewhere other than your brain. If you have requirements for opening PRs - how does every team member know what the requirements are beforehand? Are they written down and easy to find, like in a PR template? Are you running automated tasks for requirements like passing tests?

Are you remembering all the style rules for your code yourself? Add linters and formatters instead! You can configure your linters to make sure you never forget to remove a console.log or add a line at the end of a file again.

There are plenty of apps and organizational systems that will help you remember future tasks and reduce distractions. For example, Focus blocks distractions and schedules your breaks and Freedom will block distractions on all of your devices at once.

Learn Your IDE and Keyboard Shortcuts

There's a lot your integrated development environment (IDE) can do to help you out. Even if you haven't changed a single setting in your IDE, you've probably noticed that IntelliSense suggestions help you remember exact variable names and more. Using VS Code as an example, there's a huge list of keyboard shortcuts. Common tasks, like moving code blocks up and down in a file, are already bound and you can also bind your own. Reading the user interface docs will tell you how to hide anything that just distracts you. Combining both of those ideas - the keyboard shortcut Ctrl+K Z will open zen mode, hiding everything but the current file. The command palette will tell you all the commands you can use, so you don't have to remember them.

You can create workspaces to share settings with your coworkers. You can turn on settings sync so you don't have to edit VS Code settings for every project.

VS Code also has options like reusable code snippets, Code Actions and Quick Fixes, integrated automated tasks, a source control GUI, and debugging. I haven't even touched on added functionality from extensions!

It's a lot, but the VS Code docs have thought about Extraneous Cognitive Load and created written guides, video guides, reference docs and more!

Conclusion

“When cognitive load isn’t considered, teams are spread thin trying to cover an excessive amount of responsibilities and domains. Such a team lacks bandwidth to pursue mastery of their trade and struggles with the costs of switching contexts.” - Matthew Skelton

I hope this introduction to Cognitive Load Theory and examples of how it can be applied help you spot ways to prevent your own Cognitive Overload. In software development, we are expected to constantly learn. Part of that is setting up your brain for success while it's trying to absorb information.