Marks go to what a marker can see
You wrote excellent code. You tested it carefully. But the marker only sees what is in your portfolio.
If the proof is missing, the marker cannot give the marks. The work might be great. The marker cannot know.
Collecting evidence as you go is part of the job.
Key words
| Word | What it means | Example |
|---|---|---|
| Portfolio | A folder of your work and your proof. | plans, code, tests |
| Evidence | Proof of what you did. | a screenshot or a file |
| Annotation | A short note that explains a picture or a piece of code. | This test shows a refused booking |
| Audit trail | A record of what you did and when. | version history |
| Own work | Work that you made yourself, with sources named. | your own code |
| Requirement | Something the solution must do or be. | Join a waiting list |
| Test plan | A table of tests: what you try and what should happen. | hour 21: refused |
| Index | A list at the front that says what is in the portfolio and where. | a contents table |
The cells students fill in are left blank in this preview.
Weak and strong evidence
| Weak | Strong |
|---|---|
| A screenshot with no label | A screenshot named task-2-test-5.png and a line that says what it shows |
| "I tested it" | A test table with the expected and actual results |
| Code with no history | Commits that show how the code grew |
| A list of links | Links with who wrote them, the date, and why they are reliable |
| AI code with no record | The prompt, the AI answer, your review and what you changed |
| One big file with everything | One folder per task and an index at the front |
The cells students fill in are left blank in this preview.
Your own work
data-callouts.warning.label
The portfolio must show what you did. Do not copy another student's work. Name the source of anything that is not yours, including AI code. Ask your lecturer what you may share and what the rules on own work are.
Quick check: evidence
Have a go
Quick check: evidence
4 questionsYour answers are marked here and are not kept. A college account keeps every student’s marks.
Try it: make a clear file name
what = "Test Plan"
name = "task-2-" + "-".join(what.lower().split()) + ".pdf"
print(name)
# split() cuts the text into words. "-".join puts a dash (-) between them.
# Change what to "Bug Report" and run it again.
A portfolio folder, one task at a time
| Folder | What goes in it |
|---|---|
| 00-index | The contents table and the list of sources |
| 01-task-1-analyse-and-design | Requirements, design pack, AI prompts and reviews |
| 02-task-2-develop | Code, test plan, results, bug reports, change log |
| 03a-feedback | The questions, the replies and notes that people agreed to help (consent) |
| 03b-evaluation | The analysis, the decisions and the report |
The cells students fill in are left blank in this preview.