Skip to content

Commit 2d195b2

Browse files
authored
A bit of wordsmithing on help-scoring.md
1 parent b78e371 commit 2d195b2

File tree

1 file changed

+3
-3
lines changed

1 file changed

+3
-3
lines changed

doc/help-scoring.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -30,13 +30,13 @@ option.
3030

3131
Pub.dev tracks and stores how many times each version of each package gets downloaded. This is used to display package usage metrics.
3232

33-
The displayed download counts on pub.dev are aggregates based on raw server-side numbers counting the times a package archive has been downloaded.
33+
The displayed download counts on pub.dev are aggregates based on raw server-side numbers counting the times a package archive has been downloaded from the server.
3434

35-
The download count is not a measure of how many users a package has. A package can have a high usage with low download counts because users may cache the package in their `PUB_CACHE`, which is a global cache. Hence, a particular package version will only be downloaded once per user, even if the user calls `pub get` many times across different projects.
35+
The download count is not a direct measure of how many users a package has. A package can have a high usage with relatively low download counts, because the pub client caches the downloads in the `PUB_CACHE`. This is a shared cache, so a particular package version will only be downloaded once per user on a particular developer machine, even if the user invokes `pub get` many times across different projects.
3636

3737
On the other hand, for some packages the download count may be relatively high. For instance, the number can be high if the package is used as a dependency by other popular packages. The download counts can also be highly affected if the package is used by CI systems running tests, since these systems typically don't retain the `PUB_CACHE` between test runs.
3838

39-
The download count is by no means a perfect metric, and should only be regarded as an indicator of popularity.
39+
The download count is not a perfect metric, and should only be regarded as an indicator of popularity.
4040

4141
## Popularity
4242

0 commit comments

Comments
 (0)