From ac1c5f1ea39a204a81b6409e3ea285d3f25d6255 Mon Sep 17 00:00:00 2001 From: Sally McGrath Date: Sun, 21 Jan 2024 08:05:10 -0700 Subject: [PATCH 1/2] kill snippet again It just won't die... --- .../en/blocks/requirements/index.md | 43 +++++++++++++++++++ common-theme/layouts/shortcodes/snippet.html | 20 --------- 2 files changed, 43 insertions(+), 20 deletions(-) delete mode 100644 common-theme/layouts/shortcodes/snippet.html diff --git a/common-content/en/blocks/requirements/index.md b/common-content/en/blocks/requirements/index.md index 3bb0b4b59..7e8784fe2 100644 --- a/common-content/en/blocks/requirements/index.md +++ b/common-content/en/blocks/requirements/index.md @@ -37,3 +37,46 @@ To make great software, we need to think about people, not just code. We can discover requirements with something called 'User Stories'. The simplest user story looks like this: > As a [type of user], I can [achieve some goal]. + +#### Imagine a coursework tracker + +As trainees, you have coursework to do. Imagine a website which tracks how coursework is going for you all. Thinking about that website, some user stories could be: + +- As a trainee, I can ask for help with a topic or task. +- As a mentor, I can see who needs extra support. +- As a trainee, I can see what coursework I need to complete and when. +- As a mentor, I can see what coursework has not been completed. + +These each take the form "As [who], I can [what]". They don't say why yet. + +{{}} +In groups of about 5. + +Talk about why the "who" is useful. What would we be missing if we didn't think about the "Who"? + +Now think about the "why" for each of the listed user stories. Why are they important? + +{{}} + +> As a [who], I can [what] so that **[why]** + +{{}} + +Write some user stories for our coursework tracker on a Jamboard. + +Think about the "who", "what", and "why" for each. + +You can think of new "who"s (e.g. the people who write the coursework questions), and as many "what"s as you want - but make sure you remember the "why". +{{}} + +### Reflecting + +{{}} +A user story is a short sentence stating some goal a user can expect to achieve when using the product we are implementing. +{{}} + +{{}} +Why is thinking about user stories useful? + +What's useful about thinking about the "who" and the "why"? What could go wrong if you don't think about them? +{{}} diff --git a/common-theme/layouts/shortcodes/snippet.html b/common-theme/layouts/shortcodes/snippet.html deleted file mode 100644 index 9c855d86f..000000000 --- a/common-theme/layouts/shortcodes/snippet.html +++ /dev/null @@ -1,20 +0,0 @@ -{{- /* Initialize. */}} -{{- $asset := "" }} -{{- /* Get params. */}} -{{- with (.Get 0) }} - {{- $asset = . }} -{{- else }} - {{- errorf "The %q shortcode requires a single positional parameter; the relative path to a file in the assets directory. See %s" .Name .Position }} -{{- end }} -{{- /* Get resource. */}} -{{- $r := "" }} -{{- with .Site.GetPage $asset }} - {{- $r = . }} -{{- else }} - {{- errorf "The %q shortcode was unable to find %q. See %s" .Name $asset .Position }} -{{- end }} - -{{- /* Render resource content. */}} -{{- $r.Content | .Page.RenderString }} - -{{- /* Chomp trailing newlines. */ -}} From c348e9c9853512aa59a705ed06d423b8d7ea16c9 Mon Sep 17 00:00:00 2001 From: Sally McGrath Date: Sun, 21 Jan 2024 08:09:40 -0700 Subject: [PATCH 2/2] replace regex casualty --- org-cyf/content/js1/sprints/1/prep/index.md | 2 +- org-cyf/content/js1/sprints/4/day-plan/index.md | 2 +- org-cyf/content/js1/sprints/4/prep/index.md | 2 +- org-cyf/content/js3/sprints/1/prep/index.md | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/org-cyf/content/js1/sprints/1/prep/index.md b/org-cyf/content/js1/sprints/1/prep/index.md index 488cb8155..566b04424 100644 --- a/org-cyf/content/js1/sprints/1/prep/index.md +++ b/org-cyf/content/js1/sprints/1/prep/index.md @@ -42,7 +42,7 @@ name="Wrapping up" src="blocks/wrapping-up" [[blocks]] name= "Critical Thinking" -src= "TEMPURL-/blocks/prep-critical-thinking/readme/" +src= "https://cyf-pd.netlify.app/blocks/prep-critical-thinking/readme/" +++ ## Interacting with computers. diff --git a/org-cyf/content/js1/sprints/4/day-plan/index.md b/org-cyf/content/js1/sprints/4/day-plan/index.md index 2eb7aaf64..7575c7896 100644 --- a/org-cyf/content/js1/sprints/4/day-plan/index.md +++ b/org-cyf/content/js1/sprints/4/day-plan/index.md @@ -11,7 +11,7 @@ name="Energiser" src="blocks/energiser" [[blocks]] name= "Asking good technical questions" -src= "TEMPURL-/blocks/asking-good-technical-questions/readme/" +src= "https://cyf-pd.netlify.app/blocks/asking-good-technical-questions/readme/" [[blocks]] name="Progress check-in" src="https://github.com/CodeYourFuture/Module-JS1/issues/124" diff --git a/org-cyf/content/js1/sprints/4/prep/index.md b/org-cyf/content/js1/sprints/4/prep/index.md index f9ed4c404..f623a5bca 100644 --- a/org-cyf/content/js1/sprints/4/prep/index.md +++ b/org-cyf/content/js1/sprints/4/prep/index.md @@ -35,5 +35,5 @@ src="module/js1/generalise" name="generalise" [[blocks]] name= "Asking good questions" -src= "TEMPURL-/blocks/prep-asking-good-questions/readme/" +src= "https://cyf-pd.netlify.app/blocks/prep-asking-good-questions/readme/" +++ diff --git a/org-cyf/content/js3/sprints/1/prep/index.md b/org-cyf/content/js3/sprints/1/prep/index.md index f93301780..2d1f7c39e 100644 --- a/org-cyf/content/js3/sprints/1/prep/index.md +++ b/org-cyf/content/js3/sprints/1/prep/index.md @@ -35,5 +35,5 @@ name="using-map" src="module/js3/using-map" [[blocks]] name= "Prep Teamwork Project" -src= "TEMPURL-/blocks/prep-teamwork-project/readme/" +src= "https://cyf-pd.netlify.app/blocks/prep-teamwork-project/readme/" +++