Topic 8 · Programming · 8.14

Maintainable Programs Explained Simply

A maintainable program is easy for another programmer to read, understand, test and change safely.

Start the lesson Explore the Learning Hub
Invitation

Could another programmer understand your code?

A program may work correctly today, but another programmer might need to fix it or add a new feature later.

A maintainable program is written so that its purpose and structure are easy to understand.

Good code should not only work. It should also be easy to follow and change.
Figure 1
Code has a future reader
Write the program
↓
Another programmer reads it
↓
They fix or improve it safely
Big Idea

Maintainability removes unnecessary confusion

CommentsExplain the purpose of code sections
Meaningful namesShow what identifiers store or do
SubroutinesAvoid repeated code
IndentationMake the program structure visible
Exam pattern: Name the technique, then explain how it makes the program easier to maintain.
FutureLogic Bridge

Write instructions someone else can follow

Imagine leaving instructions for another teacher to run your lesson. Notes such as “do the thing” or “use x” would be difficult to follow.

Clear headings, sensible names and organised steps make the instructions usable. Program code works in exactly the same way.

Maintainable code is like a clear set of instructions for the next person.
Figure 2
From confusion to clarity

Hard to maintain

x = 0 for a in b: x = x + a
→

Easy to maintain

total_score = 0 for score in scores: total_score += score
Worked Example

Improve the same program without changing its result

BeforeDifficult to follow
x ← 0
FOR i ← 1 TO 5
  x ← x + s[i]
NEXT i
OUTPUT x
AfterMaintainable pseudocode
// Calculate the total score
TotalScore ← 0
FOR ScoreIndex ← 1 TO 5
  TotalScore ← TotalScore + Scores[ScoreIndex]
NEXT ScoreIndex
OUTPUT TotalScore

What improved?

The program gives the same output, but the comment and meaningful identifiers reveal its purpose immediately.

Pseudocode and Python

The techniques work in every language

PseudocodeClear structure
// Calculate the average mark
Total ← 0
FOR Index ← 1 TO ClassSize
  Total ← Total + Marks[Index]
NEXT Index
Average ← Total / ClassSize
PythonSame structure
# Calculate the average mark
total = 0
for mark in marks:
    total += mark

average = total / len(marks)
Comments explain why a section exists. Clear code shows how it works.
Exam Tip

Technique plus explanation earns the marks

For an explain question, simply writing “use comments” is usually not enough.

Focused answer: “Use meaningful identifier names so another programmer can understand the purpose of variables and subroutines.”

A complete six-mark approach

Give three techniques and explain how each one improves readability or makes future changes safer.

Common Mistake

Do not list techniques without explaining them

Weak: “Use comments, indentation and subroutines.”
Stronger: “Use subroutines to avoid repeated code, so a change only needs to be made in one place.”

The explanation must show how the technique helps another programmer maintain the code.

Summary

Four habits make code maintainable

1Use meaningful identifiers
2Add useful comments
3Use clear indentation
Use subroutines to reduce repeated code and simplify the program.