Sparse checkout instructions exclude lesson assets needed for hands-on projects[Docs + DX]

[adjetey0]

Description
The README recommends using sparse checkout to avoid downloading 50+ translations:

git sparse-checkout set --no-cone '/*' '!translations' '!translated_images'

Problem: Several lessons reference images and starter files that live inside translations/ even for the English course. Example: 1-getting-started-lessons/3-accessibility/translations/README.md contains the main lesson for some languages, but 1-getting-started-lessons/3-accessibility/assignment.md links to ./images/terrarium.png which only exists in translated_images/espanol/images/.

Result: Students following the sparse checkout steps get broken images and missing starter files for lessons like the terrarium, space game, and browser extension. They think the repo is broken.

Proposed Solution

1. Audit lesson dependencies: Move all required assets for the default English track out of translations/ and translated_images/ into each lesson folder.

2. Update sparse checkout command: If some shared assets must stay in translated_images, change the command to:

   git sparse-checkout set --no-cone '/*' '!translations' 'translated_images/english'

   Or keep a /assets folder at root with all required images.

3. Add warning: Note in README that sparse checkout will break specific lessons unless assets are included.

4. CI check: Add GitHub Action to fail if any _.md in default lessons links to a path excluded by the recommended sparse checkout.

Acceptance Criteria

• Cloning with README sparse checkout command lets users complete all 24 lessons without 404s for images/assets
• No lesson .md in the English path references translations/ or translated_images/
• README clearly lists which lessons break if users exclude images
• Test: Run sparse checkout, then find . -name "_.html" -o -name "*.md" | xargs grep "src=" | grep "404" returns nothing

Technical Notes
Affected lessons so far: terrarium project, typing-game, browser-extension. All link to images under translated_images/. The course is “project-based” so broken assets block completion.

Priority:High — breaks onboarding for beginners, which is the core audience
Labels: bug, documentation, good-first-issue, help-wanted

[adityas27]

Hi @adjetey0 👋

I'm looking to start contributing to open source, and Id like to work on this issue if it's available. Could you please assign it to me?
From what I can see this issue can be split into a few smaller tasks. I'll start by updating the README.md to add a warning about the current sparse checkout limitation and then I'll work on addressing the underlying issue in separate, focused changes if that aligns with the project's preferred approach.
Please let me know if that sounds good Thanks!

Edit: Issue is likely fixed. I tried reproducing it some examples mentioned in issues. It seems like most of them have images folder now which translated_images issue