Blame

0648ae lisa 2026-06-08 09:18:19
Add C05 student wiki pages: design tools, annotation, traceability Six DRAFT pages under /sd/C05 targeting common rubric-boundary errors: - Sketch vs Mock-up (C5-1) — embeds two videos - Data Dictionary — Format is not Type (C5-1) - IPO Charts — Process Means Steps (C5-1) - VCAA Pseudocode — Not Python (C5-1) - The Annotation Verb Ladder (C5-2) - Connect the Dots — design traceability (C5-3) Pages 2-6 have video slots pending teacher selection. Home index reorganised by indicator. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1
> **DRAFT** — under teacher review.
2
3
# Connect the Dots — Trace One Feature Through Every Layer
4
5
The Hamilton and Alexandra College · Year 12 · 2026
6
7
Your designs are not arbitrary choices. Every element you put on a screen should connect back to a real user need in your SRS, and every requirement should trace forward to a concrete implementation. This page shows you how to make that thinking visible — which is exactly what C5-3 Step 2 is testing.
8
9
The performance descriptor goes from "outlines connections" (annotations only) up to "documents connections across design ideas, requirements **and** detailed designs." That last level — full traceability — is the 9–10 evidence.
10
11
---
12
13
## 🎬 Watch
14
15
> [!NOTE]
16
> Video coming soon.
17
18
**🎯 Watch for:** how to follow a single design decision all the way from the mood board through to pseudocode, and why stopping at the mock-up is the most common reason students miss the top band.
19
20
---
21
22
## Three Levels of Connection
23
24
Work through these in order. Each level adds a layer on top of the last.
25
26
### Level 1 — Annotate Your Designs
27
28
Add a written reason to every significant element in your sketches and mock-ups.
29
30
A weak annotation describes: *"The button is red."*
31
32
A strong annotation justifies: *"Red delete button — follows platform convention and creates a visual stop-sign effect, reducing accidental deletion for non-technical users."*
33
34
> [!TIP]
35
> The test for a good annotation: can you name the alternative you considered and why you rejected it? If yes, you are justifying. If no, you are only describing.
36
37
Examples from a typical SAT project:
38
39
- *"Dropdown instead of text field → reduces input errors for non-technical users"*
40
- *"Red colour for delete button → follows convention, prevents accidental use"*
41
42
### Level 2 — Link to Your SRS Requirements
43
44
Map each design feature back to a requirement using the **same numbering as your SRS** (FR-1, NFR-3, etc.). This is what separates "I thought it looked good" from "this decision was required."
45
46
| Design Element | Requirement (SRS ref) | Justification |
47
|---|---|---|
48
| Search bar on home screen | FR-3: Users can search by name | Fastest path to core feature |
49
| Password strength indicator | NFR-2: Security | Guides users without explaining rules |
50
| Offline mode indicator | NFR-5: Reliability | Users need to know when data may be stale |
51
52
Build this table for your own project using your own SRS numbers. Every significant design decision should appear in it.
53
54
### Level 3 — Trace Through to Detailed Designs
55
56
This is the level most students miss. Once you have a design element annotated and linked to the SRS, you need to show that the same decision flows forward into your detailed designs: the data dictionary, the IPO chart, and the pseudocode.
57
58
The diagram below shows what that chain looks like for one feature.
59
60
```mermaid
61
flowchart TD
62
A["🖼️ Mood board<br/>Search icon included<br/>in initial style references"]
63
B["📐 Mock-up<br/>Search bar placed top-centre<br/>on home screen (Step 1)"]
64
C["📋 SRS link<br/>FR-3: Users can search<br/>by name or category"]
65
D["🗄️ Data dictionary<br/>field: search_query<br/>type: String<br/>format: max 100 chars"]
66
E["📊 IPO chart<br/>Input: search_query<br/>Process: filter records<br/>Output: filtered list"]
67
F["💻 Pseudocode<br/>IF search_query is not empty THEN<br/> results ← filterBy(search_query)<br/>ENDIF"]
68
69
A --> B
70
B --> C
71
C --> D
72
D --> E
73
E --> F
74
```
75
76
If you can draw this chain for your most important feature, you have Level 3 evidence.
77
78
---
79
80
## The Performance Ladder
81
82
| Level | What your evidence looks like |
83
|---|---|
84
| Basic | Designs exist but no written reasons |
85
| Developing | Some annotations, inconsistent |
86
| Proficient | Annotations on most elements — outlines connections |
87
| Strong | Annotations + SRS table — documents connections to requirements |
88
| Excellent | Annotations + SRS table + full trace to detailed designs — 9–10 band |
89
90
Stopping at the mock-up is the most common failure mode. A well-annotated, well-linked mock-up with no trace into the data dictionary or pseudocode caps you at the Strong level. Full traceability is what lifts the work into the top band.
91
92
---
93
94
## Common Mistakes
95
96
- **Connections implied, not documented** — you know why you made the decision, but you never wrote it down. Markers can only assess what is on the page.
97
- **No SRS reference** — annotations explain the choice but never name the requirement it satisfies. The link between design and requirements is missing.
98
- **Trace stops at the mock-up** — the design looks connected, but there is no data dictionary entry, no IPO chart, no pseudocode that picks up the same feature.
99
- **Wrong SRS numbering** — you use different identifiers in the table than you used in your SRS. Use the exact same labels (FR-3, not "Functional Requirement 3").
100
101
---
102
103
## Quick Checklist
104
105
- [ ] Annotations added to sketches and mock-ups explaining each significant design choice
106
- [ ] Each annotation names an alternative and gives a reason (justifies, not just describes)
107
- [ ] Each significant design element linked to at least one SRS requirement (FR- or NFR- number)
108
- [ ] Traceability table built: Design Element | Requirement (SRS ref) | Justification
109
- [ ] At least one feature traced all the way: mood board → mock-up → data dictionary → IPO chart → pseudocode
110
- [ ] Connections documented in writing, not just implied
111
112
---
113
114
## Check Your Understanding
115
116
1. A student writes "I used a dropdown menu because it looks cleaner." What is missing from this annotation?
117
118
>| **Answer:** The annotation describes a visual preference but does not name an alternative or link to a user need. A stronger version: "Dropdown instead of free-text field → limits input to valid options, reducing input errors for non-technical users (FR-3)." It needs the rejected alternative, the user-facing reason, and the SRS reference.
119
120
2. Your mock-up has a search bar that is fully annotated and linked to FR-3. What additional evidence do you need to reach the top performance band?
121
122
>| **Answer:** You need to trace the feature forward into your detailed designs — a data dictionary entry for the search field, an IPO chart showing search as a process, and pseudocode that implements it. Stopping at the mock-up, even a well-annotated one, caps you below the 9–10 band.
123
124
3. Why must the SRS references in your traceability table use the same numbering as your SRS document?
125
126
>| **Answer:** The marker needs to verify the link exists. If you write "FR-3" in your traceability table, they can turn to FR-3 in your SRS and confirm the connection. Inconsistent labelling breaks the chain and suggests you have not actually mapped the decisions — it looks like the connections are invented rather than documented.
127
128
---
129
130
## See also
131
132
- [Sketch vs Mock-up](/sd/C05/Sketch%20vs%20Mock-up)
133
- [Data Dictionary — Format is not Type](/sd/C05/Data%20Dictionary%20-%20Format%20is%20not%20Type)
134
- [IPO Charts — Process Means Steps](/sd/C05/IPO%20Charts%20-%20Process%20Means%20Steps)
135
- [VCAA Pseudocode — Not Python](/sd/C05/VCAA%20Pseudocode%20Not%20Python)
136
- [Plan B Contingency Table](/sd/C05/Plan%20B%20Contingency%20Table)
137
138
← Back to [C05 Home](/sd/C05/C05-home) · [VCE Software Development Hub](/sd/VCE%20Software%20Development%20Hub)