Blame
|
1 | > **DRAFT** — under teacher review. |
||||||
| 2 | ||||||||
| 3 | # Connect the Dots |
|||||||
| 4 | ||||||||
| 5 | The Hamilton and Alexandra College · Year 12 · 2026 |
|||||||
| 6 | ||||||||
| 7 | C5-3 asks you to do more than produce nice-looking designs — it asks you to make your **thinking visible**. The performance descriptors say it clearly: |
|||||||
| 8 | ||||||||
| 9 | > "Outlines the connections between the design ideas using annotations · Documents the connections between the design ideas and solution requirements · Documents the connections between the design ideas, solution requirements and the detailed designs." |
|||||||
| 10 | ||||||||
| 11 | Notice the three rising levels: annotate → link to requirements → trace all the way through to code-level artefacts. Each level builds on the one before, and stopping early is the single most common reason students miss the top band. |
|||||||
| 12 | ||||||||
| 13 | --- |
|||||||
| 14 | ||||||||
| 15 | ## Level 1 — Annotate your designs |
|||||||
| 16 | ||||||||
| 17 | An annotation is not a description. Saying "the button is red" tells the reader what you built. A real annotation tells them **why** — and implies you considered an alternative. |
|||||||
| 18 | ||||||||
| 19 | Test yourself with this question: *Can I name the thing I didn't do, and explain why I rejected it?* |
|||||||
| 20 | ||||||||
| 21 | | Weak annotation (describes) | Strong annotation (justifies) | |
|||||||
| 22 | |---|---| |
|||||||
| 23 | | "The button is red." | "Red delete button — follows the stop-sign convention and creates friction before an irreversible action, reducing accidental deletion. Considered orange but red is the universal danger signal." | |
|||||||
| 24 | | "I used a sans-serif font." | "Inter (sans-serif) chosen over a serif font — cleaner at small sizes on screen; the target display is 1080p at arm's length, where serifs add noise." | |
|||||||
| 25 | | "The health bar is at the top-left." | "Health bar anchored top-left to match the player's primary scan path; tested top-right in early sketch but eye-tracking research shows players check top-left first in action games." | |
|||||||
| 26 | ||||||||
| 27 | The more you justify, the more evidence you give a marker that you made a **deliberate design decision**, not a guess. |
|||||||
| 28 | ||||||||
| 29 | > [!TIP] |
|||||||
| 30 | > If your annotation could also describe someone else's completely different design, it is too vague. Revise until it only makes sense for *your* choice. |
|||||||
| 31 | ||||||||
| 32 | --- |
|||||||
| 33 | ||||||||
| 34 | ## Level 2 — Link to your SRS requirements |
|||||||
| 35 | ||||||||
| 36 | Every design feature exists because of a requirement. Level 2 makes that link **explicit and traceable** — using the exact same reference numbers as your SRS document. |
|||||||
| 37 | ||||||||
| 38 | If your SRS says FR-3 and your design log says "requirement 3" or "functional requirement about jumping", the marker cannot confirm the trace. Use the **same label**, exactly. |
|||||||
| 39 | ||||||||
| 40 | Include a traceability table in your design log. Here is an example from a Godot game project: |
|||||||
| 41 | ||||||||
| 42 | | Design element | Requirement (SRS ref) | Justification | |
|||||||
| 43 | |---|---|---| |
|||||||
| 44 | | Double-jump shown as two small arc icons on HUD | FR-3 (player may jump twice before landing) | Icons make the remaining jump count readable at a glance during gameplay, satisfying FR-3's need for real-time feedback on jump state. | |
|||||||
| 45 | | Health pickup glows green for 0.5 s on collection | FR-7 (player receives visual confirmation of pickup) | Glow duration is long enough to register but short enough not to distract; fulfils FR-7 without impeding player focus. | |
|||||||
| 46 | | Settings screen accessible from pause menu only | NFR-2 (system shall not interrupt active gameplay) | Restricting settings access to the pause state ensures NFR-2 is never violated by an accidental menu trigger mid-run. | |
|||||||
| 47 | ||||||||
| 48 | > [!NOTE] |
|||||||
| 49 | > Your table does not need to include every design element — but every element in the table must have a matching SRS entry. If you invent a reference number, markers will look it up and find nothing. |
|||||||
| 50 | ||||||||
| 51 | --- |
|||||||
| 52 | ||||||||
| 53 | ## Level 3 — Trace through to detailed designs |
|||||||
| 54 | ||||||||
| 55 | The top band requires you to show a feature flowing continuously from inspiration all the way into code-level artefacts. Here is one complete trace for a **double-jump** feature in a Godot platformer. |
|||||||
| 56 | ||||||||
| 57 | ```mermaid |
|||||||
| 58 | flowchart TD |
|||||||
| 59 | A["Mood board<br/>Platformer jump-feel references<br/>(Celeste, Hollow Knight)"] --> B["Sketch<br/>Early HUD concept showing<br/>jump-arc indicator"] |
|||||||
| 60 | B --> C["Mock-up<br/>Annotated HUD with<br/>two arc icons, colour states"] |
|||||||
| 61 | C --> D["Data Dictionary<br/>jumpsRemaining : Integer<br/>Range 0-2, default 2"] |
|||||||
| 62 | D --> E["IPO Chart<br/>Input: jump key pressed<br/>Process: check jumpsRemaining<br/>Output: apply upward force or block"] |
|||||||
| 63 | E --> F["Pseudocode<br/>IF jumpsRemaining is above 0<br/>THEN apply force and decrement<br/>ELSE play error sound"] |
|||||||
| 64 | ``` |
|||||||
| 65 | ||||||||
| 66 | Each node in that chain leaves evidence in a different artefact. A marker reading your folio can pick up any artefact — the data dictionary, the IPO chart, the pseudocode — and trace it back to the mood board and forward to the next layer. |
|||||||
| 67 | ||||||||
| 68 | > [!TIP] |
|||||||
| 69 | > The most common failure point is stopping at the mock-up. A beautifully annotated mock-up earns Proficient. Full traceability into the data dictionary, IPO and pseudocode is what earns the top band. |
|||||||
| 70 | ||||||||
| 71 | --- |
|||||||
| 72 | ||||||||
| 73 | ## Performance ladder |
|||||||
| 74 | ||||||||
| 75 | | Band | What your evidence shows | |
|||||||
| 76 | |---|---| |
|||||||
| 77 | | Basic (1–4) | Designs exist but have no written reasons; annotations describe rather than justify | |
|||||||
| 78 | | Developing (5–6) | Some annotations present; connections to requirements implied but not mapped | |
|||||||
| 79 | | Proficient (7–8) | Annotations clearly outline connections between design ideas; alternative choices mentioned | |
|||||||
| 80 | | Strong (8–9) | Traceability table maps design elements to SRS references with justification | |
|||||||
| 81 | | Excellent (9–10) | Full trace from inspiration through mock-up into data dictionary, IPO and pseudocode; every artefact is connected | |
|||||||
| 82 | ||||||||
| 83 | --- |
|||||||
| 84 | ||||||||
| 85 | ## Quick checklist |
|||||||
| 86 | ||||||||
| 87 | - [ ] Every significant design element has an annotation that **justifies**, not just describes |
|||||||
| 88 | - [ ] Each annotation names the alternative I rejected and why |
|||||||
| 89 | - [ ] My traceability table uses **exact SRS reference numbers** (FR-x, NFR-x) |
|||||||
| 90 | - [ ] Every SRS ref in my table actually exists in my SRS document |
|||||||
| 91 | - [ ] I can trace at least one feature from mood board all the way to pseudocode |
|||||||
| 92 | - [ ] My data dictionary has an entry for every variable named in my IPO charts |
|||||||
| 93 | - [ ] My IPO charts connect to my pseudocode (same variable names, same logic) |
|||||||
| 94 | ||||||||
| 95 | --- |
|||||||
| 96 | ||||||||
| 97 | ## Check Your Understanding |
|||||||
| 98 | ||||||||
| 99 | **Q1. What is missing from this annotation: "I used a dropdown because it looks cleaner"?** |
|||||||
| 100 | ||||||||
| 101 | >| The annotation describes an aesthetic preference but gives no justification. It does not name what "cleaner" means in context (fewer visible options, reduced cognitive load, less screen space?), does not reference an alternative that was considered (e.g. radio buttons, a list box), and does not link to any SRS requirement. A strong revision would explain *why* a dropdown serves this specific design better than the alternative and cite the relevant requirement. |
|||||||
| 102 | ||||||||
| 103 | **Q2. You have a well-annotated mock-up with a traceability table. What extra evidence pushes you into the top band?** |
|||||||
| 104 | ||||||||
| 105 | >| You need to trace at least one feature all the way through to detailed design artefacts: a data dictionary entry (naming the variable, its type and valid range), an IPO chart that uses the same variable names, and pseudocode that implements the logic from the IPO chart. The mock-up and table earn Strong; the continuous trace from mock-up into data dictionary, IPO and pseudocode is the Excellent-band move. |
|||||||
| 106 | ||||||||
| 107 | **Q3. Why must the SRS reference numbers in your traceability table match your SRS document exactly?** |
|||||||
| 108 | ||||||||
| 109 | >| The traceability table is only useful if a reader can verify the link. If your table says FR-3 but your SRS labels it FR-03 or "Requirement 3" or omits a number entirely, the marker cannot confirm the connection exists — and may treat it as unsubstantiated. Consistency of labelling is what makes a trace auditable. |
|||||||
| 110 | ||||||||
| 111 | --- |
|||||||
| 112 | ||||||||
| 113 | ## See also |
|||||||
| 114 | ||||||||
| 115 | - [Shoulders of Giants](/sd/C05/Shoulders%20of%20Giants) |
|||||||
| 116 | - [Plan B Ready](/sd/C05/Plan%20B%20Ready) |
|||||||
| 117 | - [Sketch vs Mock-up](/sd/C05/Sketch%20vs%20Mock-up) |
|||||||
| 118 | - [Data Dictionary](/sd/C05/Data%20Dictionary) |
|||||||
| 119 | - [IPO Charts — Process Means Steps](/sd/C05/IPO%20Charts%20-%20Process%20Means%20Steps) |
|||||||
| 120 | - [VCAA Pseudocode — Not Python](/sd/C05/VCAA%20Pseudocode%20Not%20Python) |
|||||||
| 121 | - [C05 Resources](/sd/Resources/C05-Resources) |
|||||||
| 122 | ||||||||
| 123 | --- |
|||||||
| 124 | ||||||||
| 125 | ← Back to [C05 Home](/sd/C05/C05-home) · [VCE Software Development Hub](/sd/VCE%20Software%20Development%20Hub) |
|||||||
