From fe66c6960701f3bc5e0816ff34c07cc78f4e4bd5 Mon Sep 17 00:00:00 2001 From: Sally McGrath Date: Thu, 24 Oct 2024 12:31:32 +0100 Subject: [PATCH 1/8] it's more like 150 words --- .../overview/index.md | 75 +++++++++++++++++++ org-cyf-how-this-works/content/prep/index.md | 3 + 2 files changed, 78 insertions(+) create mode 100644 common-content/en/module/how-our-curriculum-works/overview/index.md diff --git a/common-content/en/module/how-our-curriculum-works/overview/index.md b/common-content/en/module/how-our-curriculum-works/overview/index.md new file mode 100644 index 000000000..003754624 --- /dev/null +++ b/common-content/en/module/how-our-curriculum-works/overview/index.md @@ -0,0 +1,75 @@ ++++ +title="Overview" +description="tl;dr How Our Curriculum Works" +emoji="🦌" +time=2 +[objectives] + 1="Explain the structure of our curriculum" +[build] + render = 'never' + list = 'local' + publishResources = false + ++++ + +### tl;dr + +Courses are divided into modules. Each module focuses on the listed module learning objectives. Modules are divided into _n_ sprints. Each sprint is 1 week long and contains the following sequenced activities, in this order: 1. Prep -> 2. Backlog -> 3. Day Plan -> 4. Success + +
+
+ +##### 1. Start with the: **🧑🏾‍💻 Prep**
+ +
+Explains the main concepts of the sprint +
+
+ +- **Learners** complete prep before class +- **Mentors** browse prep for context +
+
+ +##### 2. Then go to: **🏷️ Backlog**
+ +
+Lists coursework as issues on a linked module repo +
+
+ +- **Learners** clone issues to project boards +- **Mentors** monitor boards for progress +
+
+ +##### 3. For class it's the: **🧑🏾‍🤝‍🧑🏾 Day Plan**
+ +
+Timestamped agenda for class day +
+
+ +- Standards: + - busy morning workshop sion + - quieter afternoon study-group +- Everyone must review the plan to prepare for class +
+
+ +##### 4. Review with: **✅ Success** + +
+ +
Lists learning objectives for the sprint
+
+ +- **Learners** check off goals +- **Mentors** help us focus on the sprint goals +
+
+ +### Still lost? + +1. 🔍 Search: filter by module, sprint, and view. +1. 🦉 [Overview](/overview): your high level map with themes. diff --git a/org-cyf-how-this-works/content/prep/index.md b/org-cyf-how-this-works/content/prep/index.md index ce07e9e62..6a80d1f2a 100644 --- a/org-cyf-how-this-works/content/prep/index.md +++ b/org-cyf-how-this-works/content/prep/index.md @@ -27,4 +27,7 @@ src="module/how-our-curriculum-works/curriculum" [[blocks]] name="🛣️ using this module" src="module/how-our-curriculum-works/using-this-module" +[[blocks]] +name="overview" +src="module/how-our-curriculum-works/overview" +++ From 775b266aaed52b35896acd5b1edc9ee282c7202d Mon Sep 17 00:00:00 2001 From: Sally McGrath Date: Thu, 24 Oct 2024 13:00:34 +0100 Subject: [PATCH 2/8] self review have made it more paragraphs so it all fits on one laptop screen --- .../overview/index.md | 55 +++---------------- 1 file changed, 8 insertions(+), 47 deletions(-) diff --git a/common-content/en/module/how-our-curriculum-works/overview/index.md b/common-content/en/module/how-our-curriculum-works/overview/index.md index 003754624..acf2c371c 100644 --- a/common-content/en/module/how-our-curriculum-works/overview/index.md +++ b/common-content/en/module/how-our-curriculum-works/overview/index.md @@ -12,62 +12,23 @@ time=2 +++ -### tl;dr +Courses are divided into modules. Each module focuses on the listed module learning objectives. Modules are divided into _n_ sprints. Each sprint contains the following activities, in **this order**: -Courses are divided into modules. Each module focuses on the listed module learning objectives. Modules are divided into _n_ sprints. Each sprint is 1 week long and contains the following sequenced activities, in this order: 1. Prep -> 2. Backlog -> 3. Day Plan -> 4. Success +##### 1. Start with the: **🧑🏾‍💻 Prep** -
-
+_Explains the main concepts of the sprint._ **Learners** complete prep before class & **Mentors** browse prep for context. -##### 1. Start with the: **🧑🏾‍💻 Prep**
+##### 2. Then go to: **🏷️ Backlog** -
-Explains the main concepts of the sprint -
-
+_Lists coursework as issues on a linked module repo_. **Learners** clone issues to project boards & **Mentors** monitor boards for progress. -- **Learners** complete prep before class -- **Mentors** browse prep for context -
-
+##### 3. For class it's the: **🧑🏾‍🤝‍🧑🏾 Day Plan** -##### 2. Then go to: **🏷️ Backlog**
- -
-Lists coursework as issues on a linked module repo -
-
- -- **Learners** clone issues to project boards -- **Mentors** monitor boards for progress -
-
- -##### 3. For class it's the: **🧑🏾‍🤝‍🧑🏾 Day Plan**
- -
-Timestamped agenda for class day -
-
- -- Standards: - - busy morning workshop sion - - quieter afternoon study-group -- Everyone must review the plan to prepare for class -
-
+_Timestamped agenda for class day._ Usually a busy morning workshop and quieter afternoon study-group. **Everyone** must review the plan to prepare for class. ##### 4. Review with: **✅ Success** -
- -
Lists learning objectives for the sprint
-
- -- **Learners** check off goals -- **Mentors** help us focus on the sprint goals -
-
+_Lists learning objectives for the sprint._ **Learners** check off goals & **Mentors** help us focus on the sprint goals. ### Still lost? From 7f342b62a1fc9bafd03f52197497092834e5cbcc Mon Sep 17 00:00:00 2001 From: Daniel Wagner-Hall Date: Thu, 24 Oct 2024 14:11:47 +0100 Subject: [PATCH 3/8] Suggested edits to discuss (#1127) * Suggested edits to discuss * Reflow --- .../overview/index.md | 22 +++++++++++-------- 1 file changed, 13 insertions(+), 9 deletions(-) diff --git a/common-content/en/module/how-our-curriculum-works/overview/index.md b/common-content/en/module/how-our-curriculum-works/overview/index.md index acf2c371c..f8ad58eee 100644 --- a/common-content/en/module/how-our-curriculum-works/overview/index.md +++ b/common-content/en/module/how-our-curriculum-works/overview/index.md @@ -12,23 +12,27 @@ time=2 +++ -Courses are divided into modules. Each module focuses on the listed module learning objectives. Modules are divided into _n_ sprints. Each sprint contains the following activities, in **this order**: +Courses are divided into modules, each with a theme. Modules are divided into week-long sprints made up of: -##### 1. Start with the: **🧑🏾‍💻 Prep** +##### 1. **🧑🏾‍💻 Prep** - the main concepts of the sprint -_Explains the main concepts of the sprint._ **Learners** complete prep before class & **Mentors** browse prep for context. +**Learners** complete prep before class. +**Mentors** browse prep to know what learners are learning. -##### 2. Then go to: **🏷️ Backlog** +##### 2. **🏷️ Backlog** - coursework assignments -_Lists coursework as issues on a linked module repo_. **Learners** clone issues to project boards & **Mentors** monitor boards for progress. +**Learners** clone issues to project boards and work on them. +**Mentors** browse issues to know what the learners are doing. -##### 3. For class it's the: **🧑🏾‍🤝‍🧑🏾 Day Plan** +##### 3. **🧑🏾‍🤝‍🧑🏾 Day Plan** - timestamped agenda for class -_Timestamped agenda for class day._ Usually a busy morning workshop and quieter afternoon study-group. **Everyone** must review the plan to prepare for class. +Usually a lively morning workshop and quieter afternoon study-group. +**Everyone** should review the plan to prepare for class. -##### 4. Review with: **✅ Success** +##### 4. **✅ Success** - Learning objectives for the sprint -_Lists learning objectives for the sprint._ **Learners** check off goals & **Mentors** help us focus on the sprint goals. +**Learners** check off goals. +**Mentors** help us focus on the sprint goals. ### Still lost? From ed2f98d84ece492b04065fe915b65b938dd61ace Mon Sep 17 00:00:00 2001 From: Sally McGrath Date: Thu, 24 Oct 2024 14:12:15 +0100 Subject: [PATCH 4/8] Revert "Suggested edits to discuss (#1127)" (#1128) This reverts commit 7f342b62a1fc9bafd03f52197497092834e5cbcc. --- .../overview/index.md | 22 ++++++++----------- 1 file changed, 9 insertions(+), 13 deletions(-) diff --git a/common-content/en/module/how-our-curriculum-works/overview/index.md b/common-content/en/module/how-our-curriculum-works/overview/index.md index f8ad58eee..acf2c371c 100644 --- a/common-content/en/module/how-our-curriculum-works/overview/index.md +++ b/common-content/en/module/how-our-curriculum-works/overview/index.md @@ -12,27 +12,23 @@ time=2 +++ -Courses are divided into modules, each with a theme. Modules are divided into week-long sprints made up of: +Courses are divided into modules. Each module focuses on the listed module learning objectives. Modules are divided into _n_ sprints. Each sprint contains the following activities, in **this order**: -##### 1. **🧑🏾‍💻 Prep** - the main concepts of the sprint +##### 1. Start with the: **🧑🏾‍💻 Prep** -**Learners** complete prep before class. -**Mentors** browse prep to know what learners are learning. +_Explains the main concepts of the sprint._ **Learners** complete prep before class & **Mentors** browse prep for context. -##### 2. **🏷️ Backlog** - coursework assignments +##### 2. Then go to: **🏷️ Backlog** -**Learners** clone issues to project boards and work on them. -**Mentors** browse issues to know what the learners are doing. +_Lists coursework as issues on a linked module repo_. **Learners** clone issues to project boards & **Mentors** monitor boards for progress. -##### 3. **🧑🏾‍🤝‍🧑🏾 Day Plan** - timestamped agenda for class +##### 3. For class it's the: **🧑🏾‍🤝‍🧑🏾 Day Plan** -Usually a lively morning workshop and quieter afternoon study-group. -**Everyone** should review the plan to prepare for class. +_Timestamped agenda for class day._ Usually a busy morning workshop and quieter afternoon study-group. **Everyone** must review the plan to prepare for class. -##### 4. **✅ Success** - Learning objectives for the sprint +##### 4. Review with: **✅ Success** -**Learners** check off goals. -**Mentors** help us focus on the sprint goals. +_Lists learning objectives for the sprint._ **Learners** check off goals & **Mentors** help us focus on the sprint goals. ### Still lost? From 59ecdba5503cb64d29b9ff8e3f074457cc99c663 Mon Sep 17 00:00:00 2001 From: Sally McGrath Date: Thu, 24 Oct 2024 14:42:20 +0100 Subject: [PATCH 5/8] take daniel's edits but not his formatting 48a33a9f9804b99d13028c4c5eb96a13754cf689 --- .../module/how-our-curriculum-works/overview/index.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/common-content/en/module/how-our-curriculum-works/overview/index.md b/common-content/en/module/how-our-curriculum-works/overview/index.md index acf2c371c..1bdfcf04d 100644 --- a/common-content/en/module/how-our-curriculum-works/overview/index.md +++ b/common-content/en/module/how-our-curriculum-works/overview/index.md @@ -12,23 +12,23 @@ time=2 +++ -Courses are divided into modules. Each module focuses on the listed module learning objectives. Modules are divided into _n_ sprints. Each sprint contains the following activities, in **this order**: +Courses are divided into modules, each with a theme and learning objectives. Modules are divided into week-long sprints. Each sprint contains these activities in this order: ##### 1. Start with the: **🧑🏾‍💻 Prep** -_Explains the main concepts of the sprint._ **Learners** complete prep before class & **Mentors** browse prep for context. +_Explains the main concepts of the sprint._ **Learners** complete prep before class. **Mentors** browse prep to know what learners are learning. ##### 2. Then go to: **🏷️ Backlog** -_Lists coursework as issues on a linked module repo_. **Learners** clone issues to project boards & **Mentors** monitor boards for progress. +_Lists coursework assignments as issues_. **Learners** clone issues to project boards and work on them. **Mentors** browse issues to know what learners are doing. ##### 3. For class it's the: **🧑🏾‍🤝‍🧑🏾 Day Plan** -_Timestamped agenda for class day._ Usually a busy morning workshop and quieter afternoon study-group. **Everyone** must review the plan to prepare for class. +_Timestamped agenda for class day._ Usually a lively morning workshop and quieter afternoon study-group. **Everyone** should review the plan to prepare for class. ##### 4. Review with: **✅ Success** -_Lists learning objectives for the sprint._ **Learners** check off goals & **Mentors** help us focus on the sprint goals. +_Lists learning objectives for the sprint._ **Learners** check off goals. **Mentors** help us focus on the sprint goals. ### Still lost? From 46e62c19fd0a76997e87b642b058ec7936683a5a Mon Sep 17 00:00:00 2001 From: Sally McGrath Date: Thu, 24 Oct 2024 14:45:36 +0100 Subject: [PATCH 6/8] add primo link this will be replaced with magic class link in time --- .../en/module/how-our-curriculum-works/overview/index.md | 1 + org-cyf-itp/content/_index.md | 2 +- 2 files changed, 2 insertions(+), 1 deletion(-) diff --git a/common-content/en/module/how-our-curriculum-works/overview/index.md b/common-content/en/module/how-our-curriculum-works/overview/index.md index 1bdfcf04d..49832f697 100644 --- a/common-content/en/module/how-our-curriculum-works/overview/index.md +++ b/common-content/en/module/how-our-curriculum-works/overview/index.md @@ -34,3 +34,4 @@ _Lists learning objectives for the sprint._ **Learners** check off goals. **Ment 1. 🔍 Search: filter by module, sprint, and view. 1. 🦉 [Overview](/overview): your high level map with themes. +1. 📚 [How this works](/how-this-works): our programme in detail. diff --git a/org-cyf-itp/content/_index.md b/org-cyf-itp/content/_index.md index 24ddf3a57..d996435a5 100644 --- a/org-cyf-itp/content/_index.md +++ b/org-cyf-itp/content/_index.md @@ -1,6 +1,6 @@ +++ title="Intro to Programming" map=["start here", "programming", "next steps"] -description="Here's how you find out _what_ to do _when_" +description="New? Lost? [Quickstart](how-this-works/prep/#overview)" emoji= "🧑🏿‍🏫" +++ From d79bbbd196c2f5ae34ab7ac8f281da8201c0bf72 Mon Sep 17 00:00:00 2001 From: Sally McGrath Date: Thu, 24 Oct 2024 15:06:30 +0100 Subject: [PATCH 7/8] formatting again --- .../how-our-curriculum-works/overview/index.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/common-content/en/module/how-our-curriculum-works/overview/index.md b/common-content/en/module/how-our-curriculum-works/overview/index.md index 49832f697..4ced0c24e 100644 --- a/common-content/en/module/how-our-curriculum-works/overview/index.md +++ b/common-content/en/module/how-our-curriculum-works/overview/index.md @@ -12,23 +12,23 @@ time=2 +++ -Courses are divided into modules, each with a theme and learning objectives. Modules are divided into week-long sprints. Each sprint contains these activities in this order: +The course is divided into modules, each with a theme and learning objectives. Modules are divided into week-long sprints. Each sprint contains these activities in this order: -##### 1. Start with the: **🧑🏾‍💻 Prep** +##### 1. Start with the: **🧑🏾‍💻 Prep**, which explains the main concepts of the sprint. -_Explains the main concepts of the sprint._ **Learners** complete prep before class. **Mentors** browse prep to know what learners are learning. +**Learners** complete prep before class. **Mentors** browse prep to know what learners are learning. -##### 2. Then go to: **🏷️ Backlog** +##### 2. Then go to: **🏷️ Backlog**, a list of coursework assignments as issues. -_Lists coursework assignments as issues_. **Learners** clone issues to project boards and work on them. **Mentors** browse issues to know what learners are doing. +**Learners** clone issues to project boards and work on them. **Mentors** browse issues to know what learners are doing. -##### 3. For class it's the: **🧑🏾‍🤝‍🧑🏾 Day Plan** +##### 3. For class it's the: **🧑🏾‍🤝‍🧑🏾 Day Plan**, a timestamped agenda for class day. -_Timestamped agenda for class day._ Usually a lively morning workshop and quieter afternoon study-group. **Everyone** should review the plan to prepare for class. +Usually a lively morning workshop and quieter afternoon study-group. **Everyone** should review the plan to prepare for class. -##### 4. Review with: **✅ Success** +##### 4. Review with: **✅ Success** , the learning objectives for the sprint. -_Lists learning objectives for the sprint._ **Learners** check off goals. **Mentors** help us focus on the sprint goals. +**Learners** check off goals. **Mentors** help us focus on the sprint goals. ### Still lost? From 75936081483857d146b6aeb3df7d582f59f57f8e Mon Sep 17 00:00:00 2001 From: Sally McGrath Date: Thu, 24 Oct 2024 15:09:41 +0100 Subject: [PATCH 8/8] Update common-content/en/module/how-our-curriculum-works/overview/index.md Co-authored-by: Daniel Wagner-Hall --- .../en/module/how-our-curriculum-works/overview/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/common-content/en/module/how-our-curriculum-works/overview/index.md b/common-content/en/module/how-our-curriculum-works/overview/index.md index 4ced0c24e..4e4494ecb 100644 --- a/common-content/en/module/how-our-curriculum-works/overview/index.md +++ b/common-content/en/module/how-our-curriculum-works/overview/index.md @@ -26,7 +26,7 @@ The course is divided into modules, each with a theme and learning objectives. M Usually a lively morning workshop and quieter afternoon study-group. **Everyone** should review the plan to prepare for class. -##### 4. Review with: **✅ Success** , the learning objectives for the sprint. +##### 4. Review with: **✅ Success**, the learning objectives for the sprint. **Learners** check off goals. **Mentors** help us focus on the sprint goals.