Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

CYF Blocks (Step 5): Clarify CYF Blocks Step Instructions and Expected Output #1056

Closed
4 tasks
AmyCYF opened this issue Oct 9, 2024 · 12 comments
Closed
4 tasks
Assignees
Labels
ITD Work belongs to or is needed for ITD

Comments

@AmyCYF
Copy link
Contributor

AmyCYF commented Oct 9, 2024

Description:
There is significant confusion among participants regarding what is expected for each step in CYF Blocks. Participants are unsure about the correct output and instructions, making it difficult to assess the steps consistently. Volunteers also struggle to understand which step a participant is attempting when reviewing the code.

Acceptance Criteria:

  • Clearly define and standardise the expected output for each CYF Block step.
  • Include examples of correct output for each step.
  • Ensure that the submission includes a reference to the step number in the CYF Blocks dashboard?
  • Volunteers are able to identify the step and its expected outcome without needing to cross-reference multiple sources.

CJ/Peter - ITD Syllabus

@github-project-automation github-project-automation bot moved this to 📋 Backlog in Curriculum Planning Oct 9, 2024
@AmyCYF AmyCYF changed the title CYF Blocks (Step 5): review A/C and instructions (expected outcome, clarity of which step/question on CYF Blocks, difficult to work out what has to be done)  - CJ/Peter - ITD Syllabus CYF Blocks (Step 5): Clarify CYF Blocks Step Instructions and Expected Output Oct 9, 2024
@AmyCYF AmyCYF added the ITD Work belongs to or is needed for ITD label Oct 9, 2024
@kfklein15
Copy link
Contributor

Background
Introduce the idea of programming without the syntax
This was part of the Fundamentals course of our old curriculum

Objective of CYF Blocks in ITD
Systematic way of breaking down blocks
Should keep it low-code/no-code
Avoid children coding exercises/softwares

Should we replace it with this task? https://docs.google.com/document/d/1jYPXv5bmWyFOk4OaNi6vL1ZDVtBo4XGTqKyNOnnVwDU/edit#heading=h.4ou56z5ibfc7

@mjpeet
Copy link

mjpeet commented Oct 21, 2024

checked the "old" task description on the link (google doc), personally i find that more "supportable" by volunteers if there are questions (from trainees)

@illicitonion
Copy link
Member

One thing I'll note about CYF Blocks - we had originally hoped that it would help our trainees with things like "breaking down problems" and "understanding control flow" and similar before being exposed to JS. AFAIK we have not observed this in practice - I've never seen a trainee link what they did in CYF Blocks with what they are learning in JS.

One thing that is very cool about CYF Blocks though is that it can allow you to make interactive elements of your existing HTML page without learning any JS. Fundamentals used to do this (having people add e.g. an interactive image carousel to their website), and this is a genuinely very impressive and cool thing to be able to do without writing any code. I'm not sure if we've preserved that in the move from Fundamentals to ITD...

@cjyuan
Copy link
Contributor

cjyuan commented Oct 21, 2024

The feedbacks I saw on CYF were mainly "instructions are not clear". So I will focus on that.

Here are the changes I have in mind:
Objective of exercises: To help participants understand how to use the blocks (especially HTML and Array blocks)
To achieve this objective, I am planning to introduce block examples to explain how to use the blocks (one example for one block), then ask the participants to practice using the blocks in exercises.
To implement this suggested changes, we will need to prepare the examples and rewrite the instructions in the current exercises.

Objective of projects: To encourage participants to solve a larger problem.
Image Carousel is one of the fun one.

I think we can make some changes to some of the projects:

  • Some of them might be "too easy" (e.g., selecting a random facilitator)
  • Rewrite the spec to "encourage" them to use loops or functions.
    • (For example, in "List of links", ask them to generate a list from an array of 10 links (or from an array of variable number of links) so that they can't easily copy-paste their blocks 2 times to avoid using loop.
  • I don't know if any of them tried Story Book. I think we can give them some hints here.

@cjyuan
Copy link
Contributor

cjyuan commented Oct 21, 2024

You can preview my proposed changes via this repo:
https://github.com/cjyuan/fundamentals-blockly

You can run it from a Live Server in VSCode. There is no server-side code.
Load index-examples.html to see how the examples look like (Only 1 example at the moment).
Load index.html to see the exercises (Only the first exercise, "Change text", is modified).

You can help fixing my English later.

Let me know what you think before I make more changes.

@kfklein15
Copy link
Contributor

Thanks, @cjyuan . When we asked the ITD participants what wasn't clear on the instructions, what did they say? Would be nice for us to document the examples given or what was unclear for future reference - otherwise it is too generic.

@cjyuan
Copy link
Contributor

cjyuan commented Oct 22, 2024

@kfklein15 They just said "The instructions are confusing, difficult to follow, or not easy to understand." No much details.

And based on the questions they asked on Slack and the way they used the blocks, it seems to me that they did not know how the Html blocks work.

Also, the "green tick marks" seem to appear at unpredictable locations in the description of each exercise. The participants kept asking why they cannot find the "green tick marks" (and I couldn't answer them because I didn't know where they might appear).

@SallyMcGrath SallyMcGrath moved this from 📋 Backlog to 🏗 In progress in Curriculum Planning Oct 24, 2024
@SallyMcGrath
Copy link
Member

SallyMcGrath commented Oct 24, 2024

@cjyuan can you open it as a PR and add us as reviewers? Just because there are so many tickets and this can't get lost

update, PR is here CodeYourFuture/fundamentals-blockly#94

@SallyMcGrath
Copy link
Member

Also did you come to a conclusion about CYF Blocks vs my old Build a Personal Home Page?

@cjyuan
Copy link
Contributor

cjyuan commented Oct 24, 2024

Personal Homepage (Useful to strengthen HTML and CSS skills, just might be too similar to the Hometown Homepage in step 4)

CYF Blocks (Skills learned in this step are less useful in later module, but it is something different, fun but also intimidating)

I prefer the Personal Homepage, with additional elements to distinguish it from the task in Step 4. But at the end, it will depend on our goal.

@SallyMcGrath
Copy link
Member

What do you think about Scrimba? Do we keep it or swap it for #1103 ?

@SallyMcGrath SallyMcGrath moved this from 🏗 In progress to 👀 In review in Curriculum Planning Oct 24, 2024
@SallyMcGrath
Copy link
Member

@github-project-automation github-project-automation bot moved this from 👀 In review to ✅ Done in Curriculum Planning Oct 29, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
ITD Work belongs to or is needed for ITD
Projects
Archived in project
Development

No branches or pull requests

6 participants