Skip to content

The review says which versions it read, not what PyPI serves today - #1274

Merged
feder-cr merged 1 commit into
mainfrom
docs/review-version-is-dated
Sep 8, 2026
Merged

The review says which versions it read, not what PyPI serves today#1274
feder-cr merged 1 commit into
mainfrom
docs/review-version-is-dated

Conversation

@feder-cr

@feder-cr feder-cr commented Sep 8, 2026

Copy link
Copy Markdown
Owner

The paragraph introducing the review said the package "is on PyPI at version 0.3.0". True when it was written on 3 September; the index now serves 0.19.0.

A reader today sees a number sixteen releases behind and reasonably concludes the project has stalled, which is the opposite of what the repository shows - the wiki page argues that every claim on it is checkable, so a stale number costs it more than it would cost an ordinary page.

The sources list at the bottom already had the right shape: it dates its reading rather than asserting a present tense, so it cannot go stale. The paragraph now matches it and points at the PyPI page for the current answer.

The versions stay in the text on purpose. A review of something that ships several times a week has to say which build it looked at, or none of its claims can be checked.

Test plan

  • scripts/check_content.py clean, and its own selftest green (13 mutations caught, 6 clean cases pass)
  • scripts/check_english_only.py clean
  • One paragraph changed, no other page touched

The paragraph said the package "is on PyPI at version 0.3.0". That was true
when the review was written on 3 September; the index now serves 0.19.0, so a
reader today sees a number sixteen releases behind and reasonably concludes the
project has stalled - the opposite of what the repository shows.

The sources list already had the right shape for this: it dates its reading
("metadata checked against the index 2026-09-04") and so it cannot go stale.
This paragraph now does the same, and points at the PyPI page for the current
answer instead of trying to be it.

The versions stay in the text. A review of something that ships several times a
week has to say which build it looked at, or its claims cannot be checked at
all.
@feder-cr
feder-cr merged commit 4abc30b into main Sep 8, 2026
12 checks passed
@feder-cr
feder-cr deleted the docs/review-version-is-dated branch September 8, 2026 14:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant