docs: update npm packages to be accurate for v7

[jenniferfell]

PR Checklist

Please check if your PR fulfills the following requirements:

• The commit message follows our guidelines: https://github.com/angular/angular/blob/master/CONTRIBUTING.md#commit
• Tests for the changes have been added (for bug fixes / features)
• [X ] Docs have been added / updated (for bug fixes / features)

PR Type

What kind of change does this PR introduce?

[ ] Bugfix
[ ] Feature
[ ] Code style update (formatting, local variables)
[ ] Refactoring (no functional changes, no api changes)
[ ] Build related changes
[ ] CI related changes
[ X] Documentation content changes
[ ] angular.io application / infrastructure changes
[ ] Other... Please describe:

What is the current behavior?

Npm packages doc was not current for v7.

• Referred to old version of node
• Described yarn as default for CLI, not npm
• package lists were not current

Issue Number: N/A

What is the new behavior?

The doc needs a larger rewrite, but this PR is to make it accurate in the ways mentioned above.

Also made some copy edits.

Does this PR introduce a breaking change?

[ ] Yes
[X ] No

Other information

[IgorMinar]

this is an odd statement. The CLI scaffolds the project with the minimum amount of packages needed.

[IgorMinar]

this sounds scary. remove

[mary-poppins]

You can preview 5b38230 at https://pr26422-5b38230.ngbuilds.io/.

[mary-poppins]

You can preview 697ceab at https://pr26422-697ceab.ngbuilds.io/.

[mary-poppins]

You can preview bdbe716 at https://pr26422-bdbe716.ngbuilds.io/.

[IgorMinar]

there are still many unresolved comments on this pr

[mary-poppins]

You can preview 4e3b615 at https://pr26422-4e3b615.ngbuilds.io/.

[mary-poppins]

You can preview 2de0e55 at https://pr26422-2de0e55.ngbuilds.io/.

[mary-poppins]

You can preview b668c2d at https://pr26422-b668c2d.ngbuilds.io/.

[jenniferfell]

@IgorMinar : Ready for another look.

• Q1: is package.json workspace-scope or project-scope? I see that ng new creates a package.json at the workspace level. I see that ng generate app does not create a package.json in my new app project under projects.

  Current text: ”The CLI ng new command creates a default package.json file for your project.”

  Seems like it should either be that ng new creates a package.json for your workspace, or that both ng new and ng generate app create package.json when they create projects?

• Q2: Page title “Angular packages and dependencies” and nav title “Packages and dependencies” ? OR “Angular package dependencies” and “Package dependencies” ? Just trying something other than “npm packages” if you have a quick pref to change.

• Q3: Are these the best URLs for the devDependencies that begin @angular?

Thanks!

[IgorMinar]

A1: workspace scoped
A2: neither is great. packages are dependencies. so we just repeat the same thing using two different words. how about: “npm dependencies” and “Workspace npm dependencies”?
A3: left in inline comment. the rest looks good.

[IgorMinar]

I'm going to approve this because it's almost done. Let's change the title, resolve the other issues and get this in.

[mary-poppins]

You can preview d1eb8bd at https://pr26422-d1eb8bd.ngbuilds.io/.

[jenniferfell]

Note that ng g library does however create a package.json for the library, but it's really there for publishing the library to NPM. It's not something that would be npm installed in the project dir. I'm sure that the library details are covered elsewhere in the docs and doesn't need to be part of this page.

@Splaktar Thanks for this tip. I don't think it's covered in the AIO docs, and I don't see it clearly stated on the CLI wiki. In general, we're trying to do a better job of including information about library development (we have a few top-of-backlog items), so I included a brief mention and link to ng generate doc. We'll need to add more to that doc and address the backlog need for guide material, but I do think this is the right place to mention that libs have package.json files. Thanks again!

[mary-poppins]

You can preview 296f04f at https://pr26422-296f04f.ngbuilds.io/.

[mary-poppins]

You can preview a368f7c at https://pr26422-a368f7c.ngbuilds.io/.

[jenniferfell]

@IgorMinar Here, again. I changed navigation.json so now the PR needs a fresh approval from someone in the marketing group. Thx.

[jenniferfell]

Other than that approval, I think it's ready. I've incorporated all review feedback, updated and added cross-reference links, and moved the lists into tables that are easier to read. (When I added links, scanning the in-line titles became harder. The table fixes that.)

[Splaktar]

LGTM

[mary-poppins]

You can preview d9415fb at https://pr26422-d9415fb.ngbuilds.io/.

[angular-automatic-lock-bot]

This issue has been automatically locked due to inactivity.
Please file a new issue if you are encountering a similar or related problem.

Read more about our automatic conversation locking policy.

_{This action has been performed automatically by a bot.}