Add details on pubspec_overrides.yaml to 'Package dependencies' page

[Luckey-Elijah]

Page URL

https://dart.dev/tools/pub/dependencies.html

Page source

https://github.com/dart-lang/site-www/tree/main/src/tools/pub/dependencies.md

Describe the problem

The pub dependencies page should provide information on the pubspec_overrides.yaml file - adding a few lines to the dependency overrides section.

Currently, there is very little information on the pubspec_overrides.yaml file. The closest thing to documentation I could find was in the CHANGELOG for Dart 2.16 and some scattered discussion across various issues open on varying repositories.

Expected fix

No response

Additional context

No response

[jonasfj]

@sigurdm this seems pretty easy to do.

We should probably cover it reference documentation, which means:

• https://dart.dev/tools/pub/package-layout, and,
• https://dart.dev/tools/pub/pubspec#dependencies

The package-layout should mention that the file exists, and where you can read more about it.
Same thing about pubspec.yaml reference.

Probably the best place to put the actual documentation is in a section at the end of:
https://dart.dev/tools/pub/dependencies