Easier to read with cream paper, a tint, more contrast or larger text? Choose your colours and text, once, for every page.

Preview

Planning a software change

This is the first page of the lesson. Read it and have a go at the activities. The rest is in the full lesson.

45 minutes

Fifty emails, one app

A college has a timetable app. In one week the team gets 50 messages. Students want dark mode. A teacher found a login bug. The principal wants the college logo changed.

The team cannot do everything today. What do they do first? Who do they tell?

Key words

WordWhat it meansExample
Change requestA written ask for a change to the software.Add dark mode
PriorityHow urgent or important a change is.1 is the most urgent
ImpactWhat a change will affect.The login page and the database
ScheduleA plan of what is done and when.Login bug on Monday and Tuesday
StakeholderA person who cares about the product or is affected by it.Students, teachers, the principal
Technical audiencePeople who know how the software is built.Other developers
Non-technical audiencePeople who use the software but do not know how it is built.The principal
DocumentationWritten records of what was asked, decided and done.A change log
Regression testRun the old tests again after a change, to check that nothing else broke.
Control and releaseCheck and approve the change, then give it to the users.

The cells students fill in are left blank in this preview.

Identify and document

Changes come from feedback and reviews: messages, surveys, bug reports, meetings.

Write each one down in a change request. A good request says: what is wrong or wanted, who asked, how urgent it is, and what it might affect. Without a record, work is lost. People also argue about what was agreed.

A change request

FieldExample
NumberCR-014
WhatStudents cannot log in when the password has a space
Asked byA teacher, by email, on Monday
Priority1 (most urgent): students cannot use the app
ImpactLogin page and password check
StatusPlanned: fix on Tuesday

The cells students fill in are left blank in this preview.

Write down more than the request

data-callouts.note.label

Also write what the team decided, who agreed and the date. A change log is a list of every change, with its date. Later, nobody has to guess what happened.

Quick check: the change request

Have a go

Quick check: the change request

3 questions
Have a go: your answers are marked here and then forgotten. Sign in if you would like your score kept, and to pick up where you left off.Sign in to keep your score

Your answers are marked here and are not kept. A college account keeps every student’s marks.

Tell the right people the right way

Different people need different words. A technical audience wants details. A non-technical audience wants to know: what is happening, when it will be done, and what they must do.

Use short sentences. Do not use hard technical words with people who do not know them.

The lesson goes on

7 more parts of this lesson are in the full curriculum, with the tasks, the final check and the labs. A college account gives your students all of it.