angular / angular

Deliver web apps with confidence 🚀
https://angular.dev
MIT License
96.19k stars 25.46k forks source link

Tutorial zip broken #57075

Open Rinze-CodeGorilla opened 3 months ago

Rinze-CodeGorilla commented 3 months ago

Describe the problem that you experienced

The Angular tutorial requires downloading the project files to get started, it provides a link to a .zip file. This .zip file is broken: the files in the base directory are instead marked as being in the root directory, which means they don't extract by default, and in some tools aren't even visible. Not having the files in the base directory means I can't run npm install or ng serve because the package.json and angular configuration files are missing.

The zip files are broken in all lessons, not just the first one.

Enter the URL of the topic with the problem

https://angular.dev/tutorials/first-app/01-hello-world

Describe what you were looking for in the documentation

I want to learn Angular

Describe the actions that led you to experience the problem

Open tutorial and follow step 1 to download the files.

Start by clicking the "Download" icon in the top right pan of the code editor. This will download a .zip file containing the source code for this tutorial.

Describe what you want to experience that would fix the problem

A zip that has it's files in the right location so they extract to the right location and I can actually learn Angular

Add a screenshot if that helps illustrate the problem

Windows: Screenshot 2024-07-22 112346 Notice the extra \ to view the files from the root (should be base) directory Screenshot 2024-07-22 112400 Linux Screenshot 2024-07-22 113046

If this problem caused an exception or error, please paste it here

No response

If the problem is browser-specific, please specify the device, OS, browser, and version

No response

Provide any additional information here in as much as detail as you can

No response

9kubczas4 commented 3 months ago

Hi @JoostK,

I can take a look on this issue.

9kubczas4 commented 3 months ago

Hi,

I tried to reproduce this issue, however structure of the files looks correct for me. image I was able to install dependencies and run app via ng serve successfully.

I generated the zip using:

@Rinze-CodeGorilla could you tell me which exact OS version do you use and what tool to unzip is your choice?

JoostK commented 3 months ago

I did reproduce in Windows 10 the other day, using 7-zip. There's a src directory and all files that are supposed to be at the root have been moved into a directory named _. I didn't try on Mac at that time though, so this might have been resolved in the meantime or it could be platform dependent

9kubczas4 commented 3 months ago

Yes, I assume that probably the issue is platform-dependent. I'll continue the investigation of it.