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

Hello world tutorial is broken in several ways #55725

Open
sheariley opened this issue May 8, 2024 · 2 comments
Open

Hello world tutorial is broken in several ways #55725

sheariley opened this issue May 8, 2024 · 2 comments
Assignees
Labels
area: adev Angular.dev documentation P2 The issue is important to a large percentage of users, with a workaround
Projects
Milestone

Comments

@sheariley
Copy link

Describe the problem that you experienced

It appears that the current release of the hello world tutorial has a TON of issues; from parts of code snippets being missing in the step-by-step instructions, to missing files (package.json, etc...) in the downloaded zip files. I highly recommend someone from the Angular team go try to follow that tutorial right now (using the local development approach; not the browser-based approach, but both seem to be broken in various ways).

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 was looking for a "getting started" tutorial to refresh my Angular knowledge and learn how Angular apps are structured with the new version (v17) of Angular. The last version I used was v13; and I've read and watched videos on all the new, great stuff you guys have been working on (standalone components, strictly typed reactive forms, etc...). So I wanted to get some hands-on experience.

Describe the actions that led you to experience the problem

  • I navigated to https://angular.dev and selected "Tutorials" on the left sidebar.
  • I selected "Start coding" under the "Build your first Angular app locally via npm", because I would rather use my own IDE.
  • Started following the steps and was met with issue after issue.

Describe what you want to experience that would fix the problem

The steps should accurately describe how to follow the tutorial and have successful outcomes, obviously.

Add a screenshot if that helps illustrate the problem

No response

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

Using the latest version of Chrome and/or Firefox, VS Code, Node v20, npm v10, and Angular 17.

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

No response

@bencodezen bencodezen added the area: adev Angular.dev documentation label May 8, 2024
@ngbot ngbot bot added this to the needsTriage milestone May 8, 2024
@bencodezen bencodezen added the P2 The issue is important to a large percentage of users, with a workaround label May 8, 2024
@ngbot ngbot bot modified the milestones: needsTriage, Backlog May 8, 2024
@bencodezen bencodezen added this to In Progress in adev May 8, 2024
@bencodezen bencodezen self-assigned this May 8, 2024
@bencodezen
Copy link
Contributor

Thanks for filing this issue @sheariley! Will take a look and make sure it gets fixed!

@bencodezen
Copy link
Contributor

bencodezen commented May 8, 2024

Note: The issued PR focused specifically on the code snippets in the tutorial. Additional work will be done to ensure a smoother experience for users (i.e., do not close this issue yet).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area: adev Angular.dev documentation P2 The issue is important to a large percentage of users, with a workaround
Projects
adev
In Progress
Development

No branches or pull requests

2 participants