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

HTML Project Demos Describe Themselves as Such #51152

Closed
jeremylt opened this issue Aug 4, 2023 · 24 comments · May be fixed by freeCodeCamp/demo-projects#455
Closed

HTML Project Demos Describe Themselves as Such #51152

jeremylt opened this issue Aug 4, 2023 · 24 comments · May be fixed by freeCodeCamp/demo-projects#455
Assignees
Labels
help wanted Open for all. You do not need permission to work on these. type: feature request Threads classified to be feature requests. Implementation to be considered as a nice to have

Comments

@jeremylt
Copy link
Member

jeremylt commented Aug 4, 2023

Is your feature request related to a problem? Please describe.

Some learners seem to think that they need to replicate the demo projects for the Responsive Web Design certification exactly.

Describe the solution you'd like

Perhaps we should add some text to the demo projects like

DEMO - YOU SHOULD NOT EXACTLY REPLICATE THIS DEMO PROJECT

or

DEMO - YOU SHOULD MAKE A SIMILAR PROJECT WITH DIFFERENT CONTENT

Describe alternatives you've considered

N/A

Additional context

No response

@jeremylt jeremylt added the type: feature request Threads classified to be feature requests. Implementation to be considered as a nice to have label Aug 4, 2023
@raisedadead
Copy link
Member

I prefer the simpler language:

DEMO - YOU SHOULD MAKE A SIMILAR PROJECT WITH DIFFERENT CONTENT

@raisedadead raisedadead added the status: discussing Under discussion threads. Closed as stale after 60 days of inactivity. label Aug 4, 2023
@jeremylt
Copy link
Member Author

jeremylt commented Aug 5, 2023

Sounds good to me. I think wordsmithing to something simple that communicates the intent is ideal, especially with how multilingual our audience is.

@jdwilkin4
Copy link
Contributor

yeah, I agree with the change.
Hopefully that will clear up the misunderstanding on having to replicate the projects

@Priyakaperla
Copy link

I think
DEMO : YOU SHOULD MAKE A SIMILAR PROJECT WITH DIFFERENT CONTENT

@Sboonny
Copy link
Member

Sboonny commented Aug 5, 2023

Can we not have all caps, we can make it bold or italic if we needed the campers to pay extra attention.

@Priyakaperla
Copy link

Priyakaperla commented Aug 5, 2023 via email

@a2937
Copy link
Member

a2937 commented Aug 6, 2023

I thought I saw something similar to that warning on those projects.

There's already

Fulfill the user stories and pass all the tests below to complete this project. Give it your own personal style. Happy Coding!

I'm surprised campers are getting confused by this. I mean it's nice to have extra warnings but what was the original malfunction?

@jeremylt
Copy link
Member Author

jeremylt commented Aug 6, 2023

The 'original malfunction' is that people still regularly exactly clone the projects. That makes it harder to tell at a glance between copying and making their own projects.

@a2937
Copy link
Member

a2937 commented Aug 6, 2023

Sorry Jeremy. I wanted to know why campers thought it was acceptable to completely clone the projects. I wanted to know if it was them not reading that instruction or if the wording was too ambiguous; and to try to offer my own two cents on a possible solution.

@jeremylt
Copy link
Member Author

jeremylt commented Aug 6, 2023

Ah, I misinterpreted 'original malfunction' as 'problem' but I think perhaps you are meaning what I would call 'root cause'?

I think the message isn't clear and direct and obvious enough.

@a2937
Copy link
Member

a2937 commented Aug 6, 2023

Yes

@raisedadead
Copy link
Member

Thanks, all. @jeremylt is correct here. The main thing is people don't read.

We should go with this exact notice. Its terse, clear, and specific:

DEMO - YOU SHOULD MAKE A SIMILAR PROJECT WITH DIFFERENT CONTENT

@raisedadead raisedadead added help wanted Open for all. You do not need permission to work on these. and removed status: discussing Under discussion threads. Closed as stale after 60 days of inactivity. labels Aug 7, 2023
@sidemt
Copy link
Member

sidemt commented Aug 7, 2023

Sorry for coming in late, but I guess similar is the word that confusing campers. I think in some culture, it sounds like as though you need to replicate the original as closely as you can.

So I would rather prefer the first option:

DEMO - YOU SHOULD NOT EXACTLY REPLICATE THIS DEMO PROJECT

or even shorter:
Demo - Do not copy this project.

Also, I’d suggest not using all caps. I remember we ask campers to not overuse all-caps in our forum or Discord, then we shouldn’t do that ourselves.

@jeremylt
Copy link
Member Author

jeremylt commented Aug 7, 2023

I mostly used all caps because I forget that bold is an option. I'm all for any emphasis technique.

@moT01
Copy link
Member

moT01 commented Aug 8, 2023

Just a curiosity @jeremylt (or anyone), are we sure campers are confused and not deliberately cloning the project? I presume you had a forum discussion with someone that was confused, so I should probably just take your word for it - but there may be some that deliberately clone the project because they don't want to come up with something else.

@naomi-lgbt
Copy link
Member

I have seen a lot of campers who think that they need to duplicate the project, not create their own.

@jeremylt
Copy link
Member Author

jeremylt commented Aug 8, 2023

Its not super infrequent (and usually with someone who appears to have english as a second language) that I run into a camper that's surprised when I tell them they can make the project about anything they want and it only has to match functional requirements.

@alexshibu1
Copy link

I agree

@IoanaaCretu
Copy link

I can confirm! When I followed the course I had the impression that we should try replicate the demo. I am surprised to find out😲

@smashed
Copy link

smashed commented Sep 30, 2023

My first thought is to always replicate the project. If I can make a suggestion, maybe something that combines both sentences.

Try not to replicate this demo project and create a similar project with your own content.

@jeremylt
Copy link
Member Author

I'm always an advocate for smaller, simpler sentences whenever possible.

@namankoolwal
Copy link

Its not super infrequent (and usually with someone who appears to have english as a second language) that I run into a camper that's surprised when I tell them they can make the project about anything they want and it only has to match functional requirements.

I was under the impression that we should try to replicate the demo, but I’m surprised to learn that we shouldn’t..
if I can make a suggestion then :-
No need to copy, Make a similar project, Get Creative!

@jeremylt
Copy link
Member Author

I think actually want to say 'do not copy' instead of 'sometimes copy'

@jdwilkin4
Copy link
Contributor

I am going to go ahead and close this since it looks like a PR was merged a while back to resolve the issue.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
help wanted Open for all. You do not need permission to work on these. type: feature request Threads classified to be feature requests. Implementation to be considered as a nice to have
Projects
None yet
Development

Successfully merging a pull request may close this issue.