Skip to document
21 · Review exercise: find the faults
21

Review exercise: find the faults

Word · 5 pages in two files: flawed 2, key 3 · flawed and answer key

On this page (3)
  1. About
  2. The requirements
  3. Files

About this document

Purpose

Practise reviewing: find ten faults planted in twelve requirements before you read the answers.

When to use

After you have read the filled set, or before you review a colleague's work. Inputs: the filled set, above all the rules register, the decision tables and the requirements register (09, 10 and 11). Use the flawed file first and the key only afterwards.

How to fill it in
  • Read the twelve requirements once, from first to last, before you mark anything.
  • Mark each fault: say what is wrong, and which rule, decision or file shows it.
  • Rewrite each faulty requirement so that it is right.
  • Check the requirements against each other as well as against the rules.
  • Only then open the answer key.
What a reviewer will ask
  1. What is wrong?
  2. How do you know: which rule or file shows it?
  3. What is the corrected text?
  4. Which requirements have no fault, and why?
Common mistakes
  • Rewriting the style when the substance is wrong. You can spot it when the corrected text reads better but still breaks the same rule.
  • Missing a mix-up between the two regimes: a requirement says "any request", and you did not ask which law applies.
  • Stopping at the first fault in a requirement: your rewrite fixes one problem and keeps another.
  • Assuming every requirement has a fault: you rewrote all twelve.
  • Reading each requirement alone: you missed two requirements that cannot both be true.

Flawed, for review

The requirements

A draft of part of a requirements register for the council's request process, before review. Twelve requirements, numbered 1 to 12. Ten faults are planted, one per faulty requirement, and each fault is of a different type. Some requirements have no fault. Check them against the filled set, above all documents 09, 10 and 11.

Review exercise: find the faults, flawed version: 12 rows, 5 columns
No.RequirementPriorityTraces toTag
1The system shall log each request with its channel, route each part with DT-01 and check each FOIA or EIR part with DT-02.MustBR-05, BR-09, DT-01, DT-02LAW
2The system shall mark a request as not valid when it does not give the applicant's real name.MustBR-09, BR-10, DT-02LAWGUIDE
3The system shall set the date of receipt to the calendar date in UK local time (Europe/London) at the moment the request reached the council.MustBR-21, BR-59GUIDEMINE
4The system shall show, for each valid part, a deadline 20 days after the date of receipt.MustBR-17, BR-28LAW
5When clarification is asked for, the system shall pause the clock and resume it when the reply arrives, counting the days already used.MustBR-23, BR-30LAW
6The system shall offer a refusal under section 12 for any request whose estimate is over £450, alone or aggregated with others (DT-03).MustBR-31, BR-32, BR-35, DT-03LAW
7The system shall not let a refusal under section 12 be sent until the advice on narrowing the request is recorded.MustBR-31, BR-36, DT-03LAWGUIDE
8The system shall send each response promptly.MustBR-17, BR-28LAW
9The system shall not send a FOIA refusal notice until it names the exemption and, if that is not obvious, why it applies. The notice gives the public interest reasons where the test was applied, and describes the complaints procedure.MustBR-41, BR-61LAW
10The system shall take the date of receipt from the mail server's timestamp, in UTC.ShouldBR-21GUIDEMINE
11The system shall hold each request as a row in the shared spreadsheet, with a formula that adds the working days to the date of receipt.MustBR-18LAW
12The system shall send each refusal to the approver at least three working days before its deadline.ShouldBR-57

The answer key is in the full set

You have read the flawed version. The answer key is a separate file in the full set: 19 documents online and 56 files in one ZIP.

14 days to ask for a refund, no questions asked.

Files for this document

  • 21-review-exercise-flawed.docx 39 KB In the full set
  • 21-review-exercise-key.docx 41 KB In the full set

    Keyboard shortcuts

    / or ⌘K
    search
    [ ]
    previous and next document
    v
    filled and blank
    Esc
    close
    ?
    this list