diff --git a/lib/src/model/package.dart b/lib/src/model/package.dart
index de0fe839bd..fa39338da3 100644
--- a/lib/src/model/package.dart
+++ b/lib/src/model/package.dart
@@ -164,8 +164,8 @@ class Package extends LibraryContainer
       packageMeta == packageGraph.packageMeta ||
       packageGraph.config.autoIncludeDependencies;
 
-  /// Returns the location of documentation for this package, for linkToRemote
-  /// and canonicalization decision making.
+  /// Returns the location of documentation for this package, for making
+  /// decisions regarding the 'linkToRemote' option and canonicalization.
   late DocumentLocation documentedWhere = () {
     if (isLocal && isPublic) {
       return DocumentLocation.local;