Skip to content

fix(readme): state the outbound-request position precisely - #187

Merged
ifahimreza merged 1 commit into
mainfrom
fix/readme-outbound-wording
Sep 22, 2026
Merged

ifahimreza merged 1 commit into
mainfrom
fix/readme-outbound-wording

Conversation

@ifahimreza

Copy link
Copy Markdown
Contributor

What

Corrects the outbound-request wording in readme.txt, in the two places that
carried it, and retires the matching "open task" note in CLAUDE.md.

Why

readme.txt led with:

The version on WordPress.org makes no outbound request at all.

and then, two lines later:

Apart from that, four things make an outbound request, and each one is started by you:

That is self-contradictory, and CLAUDE.md's first non-negotiable already says
so — the absolute "must state it this precisely rather than the old absolute, or
it is simply false", with the public copy marked as an open task.

What is actually true: the WordPress.org build never checks for its own
updates
, because includes/class-saddle-updater.php is not in that zip. The
four user-initiated requests (URL upload, endpoint self-checks, Unsplash, OAuth
discovery) exist in both builds and are started by the site owner.

How

  • Lead with "never checks for its own updates" in both places (External
    services, and the "Does my content or my password go through your servers?"
    FAQ answer).
  • Drop "Apart from that", which existed only to excuse the contradiction.
  • Point the FAQ answer at External services instead of implying the .org copy is
    silent.
  • CLAUDE.md: retire the "public copy has not caught up" note. Docs and
    marketing still need the same pass.

Testing

No code change — readme.txt and CLAUDE.md only; neither ships lintable PHP.
Verified grep -c "makes no outbound request at all" readme.txt is now 0, and
that the wp.org zip still excludes the updater (grunt build → channel wporg,
includes/class-saddle-updater.php absent) while --channel=selfhosted still
includes it.

Screenshots

n/a — plain-text readme.

🤖 Generated with Claude Code

readme.txt led with "The version on WordPress.org makes no outbound request at
all" and then, two lines later, listed four things that do make one — papering
over the contradiction with "Apart from that". CLAUDE.md's first non-negotiable
calls that absolute "simply false" and flagged the public copy as an open task.

What is actually true: the WordPress.org build never checks for its own updates,
because the updater file is not in that zip. The four user-initiated requests
(URL upload, endpoint self-checks, Unsplash, OAuth discovery) exist in both
builds and are started by the site owner.

- Lead with "never checks for its own updates" in both places that carried the
  old absolute (External services, and the FAQ answer).
- Drop "Apart from that", which only existed to excuse the contradiction.
- Point the FAQ answer at External services rather than implying the .org copy
  is silent.
- CLAUDE.md: retire the "public copy has not caught up" note; docs and marketing
  still need the same pass.

No code change.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@ifahimreza
ifahimreza merged commit f3efa30 into main Sep 22, 2026
7 checks passed
@ifahimreza
ifahimreza deleted the fix/readme-outbound-wording branch September 22, 2026 18:27
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