Closed MaoShizhong closed 9 months ago
Reword the "Note: Solutions for these exercises..." part in all relevant lessons to clarify and reinforce the intent shared in the repos' READMEs
Can you clarify what you changes you have in mind here?
I do agree with the proposed changes in the exercises repos' READMEs.
@01zulfi Perhaps rewording those parts in the relevant lessons to something like
When you have completed an exercise, the solution folder for the exercise provides a solution you can look at. If your solution differs from the provided one then that's completely fine so long as you still meet the exercise's requirements. If there are any parts about the provided solution that you do not understand, feel free to ask about them in our Discord community.
Just seen that #27055 adds a needed "Read the repo README" to the first time learners are directed to the CSS exercises repo - really like that. I think this issue adds to that by being focused more on "drilling in" the understanding, so to speak, that there is no one solution to rule them all by rewording those relevant lessons' solution note.
I feel like we're doing a bit of unneeded repetition in the lesson and the repo readmes. The lesson already instructs learners to read the readmes. IMO we should only make your proposed changes in the repo readmes.
If you feel the current lessons' solution note wording is fine as it is (after the README changes) then that's no problem and we can go along with that :)
Sure. @MaoShizhong, assigned.
Checks
Describe your suggestion
A very common concern amongst foundations learners in the community is that their solution to whatever CSS/JS exercise may not be "valid" or even "good" compared to provided solution for each.
Currently from what I could find, the only explicit mention about the purpose of these solutions is in the general exercises repos' README, something that I can imagine either does not get read or does but some details easily forgotten when coming back to do the later exercises.
The lessons that link to these exercises as assignments only contain:
I believe this part in those lessons can be reworded to be more explicit about the provided solutions being only one way to do things that learners can look at after completing their own, and that as long as the requirements are met, whatever they did is valid.
Side note:
I think the exercise repos' README mention could actually be tweaked very slightly so it says
This is because several times, people have come in concerned their solution isn't valid precisely because they interpreted that note as "if your solution differs, check with the community if it's valid".
Proposed actions:
Path
Foundations
Lesson Url
https://www.theodinproject.com/lessons/foundations-intro-to-css https://www.theodinproject.com/lessons/foundations-the-cascade#assignment https://www.theodinproject.com/lessons/foundations-alignment https://www.theodinproject.com/lessons/foundations-block-and-inline#assignment https://www.theodinproject.com/lessons/foundations-fundamentals-part-4 https://www.theodinproject.com/lessons/foundations-fundamentals-part-5#assignment
(Optional) Discord Name
No response
(Optional) Additional Comments
No response