Skip to the content ForoHackers
Log inJoin

Requirements: start here

Requirements
#3363 · · Quote · Report

Requirements say what a system must do and how well it must do it, before anyone builds it. Most failed projects did not fail at coding: they built the wrong thing, or an unclear thing. Good requirements come from talking with the people who will use the system and writing down what you learned, precisely enough to test.

Key concepts

  • Functional and non-functional: what the system does, and how fast, safe, available or usable it must be.
  • Stakeholders: users, operators, buyers and regulators each want different things; find them all.
  • Testable wording: "fast" is not a requirement; "95 percent of searches return within one second" is.
  • Use cases and user stories: describe a goal from the user's side, with its normal and failing paths.
  • Change and traceability: requirements shift, so keep track of why each one exists and what depends on it.

Vocabulary

  • Acceptance criteria: the conditions that tell you a requirement is met.
  • Scope creep: the slow growth of a project beyond what was agreed.
  • Prototype: a rough version built to learn what is really needed.
  • Specification: a written, agreed description of the behaviour of a system.

What to study, in order

  1. Interview someone about a task they do, and write what they need without proposing a solution.
  2. Turn five vague wishes into testable requirements with numbers and conditions.
  3. Write use cases for a small system, including what happens when things go wrong.
  4. Build a throwaway prototype and see which requirements it overturns.
  5. Review a real specification and list its ambiguities and missing cases.

Related tags

#architecture #testing #ux #technical-writing

You are not logged in, so this goes up anonymously: no account, no name and no address is stored with it, and it may carry no link and no image. Log in or join to post under your name. Our web server's logs keep the address and time of every request for up to 14 days; to keep yours out of them, use Tor. To reach the staff in confidence, use the drop. Sign as a returning source (a key kept only in this browser)

Sending takes a few seconds here: your browser first works out a proof of work against spam.

Reply