Skip to content

docs: say what the download services do, not what one did once - #755

Merged
lens0021 merged 1 commit into
mainfrom
claude/trim-dockerfile-comment
Sep 13, 2026
Merged

lens0021 merged 1 commit into
mainfrom
claude/trim-dockerfile-comment

Conversation

@lens0021

Copy link
Copy Markdown
Collaborator

The comment beside CURL_RETRY in the Dockerfile dates an outage:

GitHub served 500s for hours on 2026-08-17, and codeload answers 429 under load.

A reader wondering why the image retries its downloads does not need the afternoon; they need what those services do on any day. The second half of that sentence already said it in the present tense, so the fix is to finish the thought and drop the date.

-# "Stable source" describes the bytes, not the service in front of them: GitHub served 500s for
-# hours on 2026-08-17, and codeload answers 429 under load. --retry-all-errors as well as --retry,
-# because curl counts a connection reset as non-transient and would not repeat it.
+# "Stable source" describes the bytes, not the service in front of them, which answers 429 under
+# load and sometimes nothing at all. --retry-all-errors as well as --retry, because curl counts a
+# connection reset as non-transient and would not repeat it.

The clause that matters is untouched: --retry-all-errors on top of --retry, because curl reads a connection reset as permanent and will not try that one again on its own.

Where this sits

CURL_RETRY is a build argument the Dockerfile passes to every curl in it — SifterSearch's release tarball, Translate's and UniversalLanguageSelector's source archives. Those are pinned by tag or commit, so the bytes never change; what can fail is the host handing them over. Three lines above it, CURL_AGENT is the other half of the same idea: the image says who is asking.

Same clean-up as #751 and #754, in the one file outside CI that had it.

🤖 Generated with Claude Code

https://claude.ai/code/session_019ghEx26MRm9V5CnCLrdUQn


Generated by Claude Code

The comment beside CURL_RETRY dates an outage. What the retries are for is that the service in
front of the bytes answers 429 under load and sometimes nothing at all, which is true on any day.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_019ghEx26MRm9V5CnCLrdUQn
@github-actions
github-actions Bot temporarily deployed to preview September 11, 2026 18:05 Destroyed
lens0021 added a commit that referenced this pull request Sep 11, 2026
The last line of `Scribunto`'s class docblock is about the time before
the class:

```diff
  * Whether this build can render Lua, and what to say when it cannot.
  *
  * wikven's two products disagree: the image compiles luasandbox into its PHP, while the binary
  * reaches Lua only by shelling out, which it can on 64-bit x86 Linux and nowhere else.
- *
- * That used to be silent -- a page invoking a module rendered "{{#invoke:Greet|hello}}".
  */
```

It is saying twice over what is already there. The first line says the
class exists to say something when Lua cannot be rendered, and the
symptom it names is in the message the class returns, thirty lines down:

```php
. ' is not in extensions, so a {{#invoke:}} is left in the page as its own source text,'
```

A reader who wants to know what a reader sees finds it where the text is
written, in the present tense, rather than in a docblock's account of
how things once were.

### Where this sits

`Scribunto` is a small pure class asked two questions by `build.php`: is
this a build that can render Lua at all (`problem()`), and is this a
site that will notice (`warning()`). The split matters because wikven
ships two products with different answers — the image compiles
luasandbox into its PHP; the binary shells out to a Lua interpreter,
which Scribunto bundles for 64-bit x86 Linux and nowhere else. A site
with no `Module:` pages is told nothing either way.

Same clean-up as #751, #754 and #755. The comment budget reads 3.30
words a line against a ceiling of 4.00 afterwards.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

https://claude.ai/code/session_019ghEx26MRm9V5CnCLrdUQn

---
_Generated by [Claude
Code](https://claude.ai/code/session_019ghEx26MRm9V5CnCLrdUQn)_

Co-authored-by: Claude <noreply@anthropic.com>
@lens0021
lens0021 merged commit 44dfac2 into main Sep 13, 2026
29 checks passed
@lens0021
lens0021 deleted the claude/trim-dockerfile-comment branch September 13, 2026 11:36

This branch was successfully deployed

No deployments
preview — 403acdb8 Deployed Sep 11, 2026 by github-actions[bot]
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.

2 participants