SOFTWARE ENGINEERING / WEEK 02

Understand the need.
Define the software.

An illustrated guide to gathering requirements, understanding stakeholders, and writing specifications and user stories.

19 study sections33 illustrations2 resources
Begin with requirements
Why software requirements matterWHY REQUIREMENTS MATTER

Study sections

Follow the order or choose a section
01

Why do requirements matter?

If we do not spend sufficient time and effort identifying and documenting requirements, there is a mismatch between what the user expec…

2 illustrations
02

Who should we ask? Stakeholders and users

When a software system is introduced it influences different types of users — from your own organisation, other organisations or end us…

2 illustrations
03

Requirement analysis: spotting problems

During requirements analysis, we analyse the gathered requirements to form a clear understanding of the exact customer requirements and…

3 illustrations
04

Five ways to gather requirements

Users identified for the Seller Portal: independent sellers, sales team/manager of companies, advertising department, logistics/shippin…

1 illustrations
05

Questionnaires and interviews

A series of questions designed to elicit specific information from users. Answers can be yes/no, a choice from a set of answers, or a l…

3 illustrations
06

Focus groups, observation and existing documents

Drawback of interviews: they offer only one perspective. Alternative: get a group of stakeholders to discuss issues and requirements. A…

3 illustrations
07

Practical guidelines and sample portal features

After requirement gathering, the Seller Portal could contain the following features.

2 illustrations
08

Functional versus non-functional requirements

Captures a functionality required by the users from the system: the user performs actions/gives inputs and the system provides an appro…

2 illustrations
09

Reliability, robustness and other quality requirements

Reliability is the extent to which a program behaves the same way over time in the same operating environment. E.g. the software should…

2 illustrations
10

What is an SRS?

In the Plan and Document perspective, requirement gathering and analysis is usually done by a system analyst, with other members of the…

1 illustrations
11

What kinds of interfaces appear in an SRS?

Broad high-level functions, each with its functional requirements. For the Seller Portal:

2 illustrations
12

Why use an SRS?

1 illustrations
13

Plan and Document versus Agile requirements

The SRS serves as an agreement between customers and developers. But in many projects customers are unsure of the requirements, and the…

0 illustrations
14

Behaviour-Driven Design (BDD)

Behaviour Driven Design (BDD) asks questions about the behaviour of an application before and during development, so that stakeholders…

1 illustrations
15

The user-story template

User stories are short, informal, plain-language descriptions of what a user wants to do within a software product, which is of value t…

2 illustrations
16

Why are user stories useful?

2 illustrations
17

SMART user stories

A good user story should be SMART: Specific, Measurable, Achievable, Relevant and Timeboxed.

1 illustrations
18

SMART: how to improve a story

Vague: “User can search for a product in the catalogue” → specific: “User can search for a product by title in the catalogue”.

2 illustrations
19

User-story limits and choosing an approach

1. Continuous contact with customers may be difficult or too expensive — customers may not want to participate or may not be available…

1 illustrations

What this guide covers: Five Week 2 sections and the complete 66-slide teaching deck, including source examples and the SMART user-story criteria.