Tip of the Week: Timebox Your Software Work

Dave Bunten (@d33bs) Research Data Engineer

January 17, 2023 November 25, 2024

Tip of the Week: Timebox Your Software Work

Programming often involves long periods of problem solving which can sometimes lead to unproductive or exhausting outcomes. This article covers one way to avoid less productive time expense or protect yourself from overexhaustion through a technique called “timeboxing” (also sometimes referenced as “timeblocking”).

TLDR (too long, didn’t read); Use timeboxing techniques such as Pomodoro® or 52/17 to help modularize your software work to ensure you don’t fall victim to Parkinson’s Law. Timeboxing may also map well to Github Issues, which allows your software tasks to be further aligned, documented, and chunked in collaboration with others.

Controlling Work Time Expansion

Have you ever spent more time than you thought you would on a task? An adage which helps explain this phenomenon is Parkinson’s Law:

“… work expands so as to fill the time available for its completion.”

The practice of writing software is not protected from this “law”. It may be affected by it in sometimes worse ways during long periods of uninterrupted programming where we may have an inclination to forget productive goals.

One way to address this is through the use of timeboxing techiques. Timeboxing sets a fixed limit to the amount of time one may spend on a specific activity. One can use timeboxing to systematically address many tasks, for example, as with the Pomodoro® Technique (developed by Francesco Cirillo) or 52/17 rule. While there are many ways to apply timeboxing, make sure to balance activity with short breaks and focus switches to help ensure we don’t become overwhelmed.

Timeboxing Means Modularization

Timeboxing has an auxiliary benefit of framing your work as objective and oftentimes smaller chunks (we have to know what we’re timeboxing in order to use this technique). Creating distinct chunks of work applies for both our daily time schedule as well as code itself. This concept is more broadly called “modularization” and helps to distinguish large portions of work (whether in real life or in code) as smaller and more maintainable chunks.

# Goals
- Finish writing paper

# Goals
- Finish writing paper
  - Create paper outline
  - Finish writing introduction
  - Check for dead hyperlinks
  - Request internal review

Breaking down large amounts of work as smaller chunks within our code helps to ensure long-term maintainability and understandability. Similarly, keeping our tasks small can help ensure our goals are achievable and understandable (to ourselves or others). Without this modularity, tasks can be impossible to achieve (subjective in nature) or very difficult to understand. Stated differently, taking many small steps can lead to a big change in an organized, oftentimes less exhausting way (related graphic).

Version Control and Timeboxing

# Repo Issues
- "Prevent foo warning" - 20 minutes
- "Remove bar feature" - 20 minutes
- "Address baz error" - 20 minutes

List of example version control repository issues with associated time duration.

The parallels between the time we give a task and related code can work towards your benefit. For example, Github Issues can be created to outline a timeboxed task which relates to a distinct chunk of code to be created, updated, or fixed. Once development tasks have been outlined as issues, a developer can use timeboxing to help organize how much time to allocate on each issue.

Using Github Issues in this way provides a way to observe task progress associated with one or many repositories. It also increases collaborative opportunities for task sizing and description. For example, if a task looks too large to complete in a reasonable amount of time, developers may work together to break the task down into smaller modules of work.

Be Kind to Yourself: Take Breaks

While timeboxing is often a conversation about how to be more productive, it’s also worth remembering: take breaks to be kind to yourself and more effective. Some studies and thought leadership have shown that taking breaks may be necessary to avoid performance decreases and impacts to your health. There’s also some indication that taking breaks may lead to better work. See below for just a few examples:

• The Importance of Taking Breaks
• Brief and rare mental “breaks” keep you focused: Deactivation and reactivation of task goals preempt vigilance decrements
• Give your ideas some legs: the positive effect of walking on creative thinking

Additional Resources

• Parkinson’s Law
• Timeboxing
• Timeblocking Additional similar notes on time management.
• Pomodoro® Technique
• 52/17 Rule
• Modularity
• Github Issues