Exercise Solution Discussion

[tuantinghuang]

Summary of current exercise formats:

1. Text + code with fill in blanks

2. Text with a linked sketch as part of the prompt

3. Text only (Open question)

---

Mockup design for links to solution

If we are to compile an index page for exercise solutions, here's a proposed design of how we can link to the solution from the exercise, similar to how we have "copy/reveal answer." (Question: Does this link to the solution page, or directly to p5 sketch?)

---

How to format the solution sketches in Notion?

Similarly to how we attach a sketch to an exercise, can we also place the sketch link as a bookmark in the exercise block , and add a label/callout (ex: web-only) so it renders as a link ("suggested answer") instead of showing the sketch? Also we can use the label to keep track of what we have only for the website, and not included in the printed version.

Something like this maybe?

[shiffman]

This works for me! I think the the "suggested solution" should link directly to a p5.js sketch.

[shiffman]

Noting this is a continuation of the discussion in #55

[shiffman]

So we're going to try the web only tag and implement this!

[shiffman]

@tuantinghuang might as well as an explanation of how to submit an exercise solution on the README as well.

[shiffman]

Noting the last piece here is to implemented the "suggested answer" label for when there is a "web only" exercise solution.

[shiffman]

We're also going to add text based solutions with a "reveal answer" button, the proposed format in Notion is as follows:

(This is the solution from #1038)

[shiffman]

One more note is that the exercise p5 sketch embeds that are now marked with "web-only" should be hidden on the chapter pages and let's use another tag as with the text solutions above!

• solution - text based exercise answer (label "reveal answer" reveals the answer)
• p5-solution - p5 sketch (label "suggested answer" link to p5 web editor)

Ok, I think we are all set with this!

[jasongao97]

Some update on this:

solution - text based exercise answer (label "reveal answer" reveals the answer)
p5-solution - p5 sketch (label "suggested answer" link to p5 web editor)

In the #1053 implementation, instead of using separate solution and p5-solution tags, I've opted for a unified solution tag where the type is inferred from the content. This approach should provide better consistency and simplified maintenance.