Skip to content

Projects: enable pull request builds by default - #13249

Draft
ericholscher wants to merge 4 commits into
mainfrom
claude/pr-13039-followup-wytaer
Draft

Projects: enable pull request builds by default#13249
ericholscher wants to merge 4 commits into
mainfrom
claude/pr-13039-followup-wytaer

Conversation

@ericholscher

@ericholscher ericholscher commented Aug 19, 2026

Copy link
Copy Markdown
Member

Pull request previews are opt-in today, so anyone who onboards without finding the setting silently misses one of the best parts of the platform. This makes external_builds_enabled default to True. Follow-up to #13039, which was closed in favor of a fresh branch — same model change, plus the docs it was missing.

The dashboard announcement is the part worth a careful read. It was keyed off external_builds_enabled, so under the new default it would never appear again. But the point of the nudge is that someone hasn't seen a preview, not that they haven't ticked a box, so it now keys off having an external version (projects/views/private.py). The matching copy change is readthedocs/ext-theme#772 — land them together, or the call to action stops matching when it appears.

Risks and open questions:

  • Cost was the open question on projects: make external_builds_enabled default to True #13039. Only newly created projects are affected, and a project that never opens a pull request never triggers a build.
  • Projects that can't build pull requests (Bitbucket, webhooks without pull request events) now carry the flag with nothing to act on it. The settings form already disables the field with an explanation there.
  • External versions are deleted 90 days after their pull request closes, so a dormant user sees the announcement again. That seems right for a re-engagement nudge, but it follows from using versions rather than build history as the signal.

New projects now have `external_builds_enabled` set to True, and the docs
describe pull request previews as on by default.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QvLJgam4eFipmYnijL4bZY
@read-the-docs-community

read-the-docs-community Bot commented Aug 19, 2026

Copy link
Copy Markdown

Documentation build overview

📚 docs | 🛠️ Build #34145635 | 📁 Comparing aca9f8b against latest (72fba47)

  🔍 Preview build  

9 files changed · ± 9 modified

± Modified

Keying the dashboard announcement off `external_builds_enabled` hides it
for everyone now that the setting defaults to True. Key it off having an
external version instead, so the nudge stays until a real pull request
build happens.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QvLJgam4eFipmYnijL4bZY
ericholscher and others added 2 commits August 19, 2026 23:38
Matches the neighboring announcement branches, and avoids a subquery.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QvLJgam4eFipmYnijL4bZY
Semantic linefeeds and a comma splice, plus match the repo's fixture
idiom in the announcement test.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QvLJgam4eFipmYnijL4bZY
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