[Python] Improve Concept Exercise: lists about concepts

[serenalucca]

Hello, if it is possible, I would like to work on this feature.

[BethanyG]

Hi @serenalucca,

Apologies - I didn't see your comments here, or I would have replied earlier. First, thank you so much for taking on this issue. We really appreciate it. ⭐

To answer your questions:

For the hints, should I be precise and put an example when possible or should I rather put the link to a ressource and let them - look by themselves?

As I commented in your PR, this is a balance. On one hand, we want the hints to "unstick" the student. On the other, we don't want to give away exact answers. I am on the fence with the way your hints are written -- they're good, but some are pretty detailed. Part of me wants to remove direct code examples. I've pinged the other Python maintainers to get their feedback.

For the introduction file I just copied the whole about doc, should I do something else?

Copying in this case was totally fine. It gives us an opportunity to remove the pieces that aren't directly relevant to the exercise. Typically, the about.md files are more detailed/comprehensive than the introduction.md files -- which are intended to focus the student only on the syntax needed to complete the exercise.

In the design file should I put the ressources?

You don't have to. Typically, I do include in the design doc the resources I worked from when I was writing/designing the concept exercise, in order to point future maintainers to what my data/starting point was. But for many of these, the starting point is the Python docs, so its not super-important.

[serenalucca]

Thank you very much for your precise answer and for your kindness, I really appreciate it! I'm going to check the PR for the modifications.

[BethanyG]

@valentin-p - Thoughts? Are we OK to close this? Ooops. Sorry. Didn't see the automation close it - but it is closed. Apologies for pinging you.

[serenalucca]

I have a few questions for this issue.

• For the hints, should I be precise and put an example when possible or should I rather put the link to a ressource and let them - look by themselves?
• For the introduction file I just copied the whole about doc, should I do something else?
• In the design file should I put the ressources?

Thanks in advance.