Clarify relationship between Description and ResolvedDescription (#4579)

* Clarify relationship between Description and ResolvedDescription

* Update lib/src/source.dart

Co-authored-by: Jonas Finnemann Jensen <jopsen@gmail.com>

---------

Co-authored-by: Jonas Finnemann Jensen <jopsen@gmail.com>

Author: sigurdm

lib/src/source.dart

@@ -177,11 +177,17 @@ abstract class Source {
 ///
 /// For a hosted package this would be the host url.
 ///
-/// For a git package this would be the repo url and a ref and a path inside
-/// the repo.
+/// For a git package this would be the repo url and a ref and a path inside the
+/// repo.
+///
+/// For a path package it is the path.
 ///
 /// This is the information that goes into a `pubspec.yaml` dependency together
 /// with a version constraint.
+///
+/// After resolution we might know more about the specifics of the package that
+/// pins the content down (such as its content-hash or git commit id) this is
+/// represented by a [ResolvedDescription].
 abstract class Description {
   Source get source;