Added info on dependency version constraints

[atsansone]

Fixes #4811

[atsansone]

/gcbrun

[dart-github-bot]

Visit the preview URL for this PR (updated for commit cd7aafc):

https://dart-dev--pr5431-fix-4811-l4rp6ph3.web.app

[parlough]

Thanks for taking this on @atsansone!

I have a few comments and suggestions, including reducing the scope a bit to focus on what we can be more confident in suggesting. Let me know if you have any questions, would like to chat further, or if you'd like me to further propose some text.

Thanks!

[parlough]

I'm not sure we need to mention this as this whole section is about dependencies in the pubspec.yaml file and recommendations for those dependencies. I think we can just focus on the best practices.

[atsansone]

@parlough : PTAL.

[parlough]

Thanks for continuing the adjustments @atsansone! Definitely easier to follow now.

I have a few remaining concerns and some suggestions to consider. Feel free to push back on anything that doesn't make sense or let me know if you'd like to chat about any of them.

Thanks again :D

[parlough]

Thanks for adding this introduction!

I think "example" was accidentally added twice though, ending up sounding like this: "An example would resemble the following example".

How about something like: "Tightening the version constraints of your dev dependencies might resemble the following:"

Suggested change

	An example of how to set versions for dependencies would resemble the
	following `pubspec.yaml` example.
	Tightening the version constraints of your dev dependencies
	might resemble the following:

[atsansone]

Fixed.

[parlough]

Thanks for those adjustments @atsansone! One more area that needs to be updated, but otherwise looks great.