Skip to content

Builds: Rename "External" version type to "Pull request" in UI and docs#13098

Open
ericholscher wants to merge 2 commits into
mainfrom
claude/sharp-albattani-ikC0j
Open

Builds: Rename "External" version type to "Pull request" in UI and docs#13098
ericholscher wants to merge 2 commits into
mainfrom
claude/sharp-albattani-ikC0j

Conversation

@ericholscher
Copy link
Copy Markdown
Member

@ericholscher ericholscher commented Jun 3, 2026

The version type label "External" is an internal code name that leaked into
the UI and docs. The style guide says to use the marketing name in
public-facing surfaces — "Pull request" is what users know this concept as.

This reverts the docs terminology change from #13090 and updates the
Django model choice label from _("External") to _("Pull request") in
builds/constants.py, so the UI (automation rules form, version type
dropdowns, etc.) now shows "Pull request" instead of "External".

Related: #13090

Screenshot 2026-06-04 at 7 39 06 PM

Generated by Claude Code


Generated by Claude Code

Reverts the terminology change from #13090 and updates the version type
label from "External" (an internal code name) to "Pull request" which
is the user-facing marketing name, per the style guide.

https://claude.ai/code/session_012wqprntUMuLqGGNskCFMxJ
@read-the-docs-community
Copy link
Copy Markdown

Documentation build overview

📚 dev | 🛠️ Build #32969433 | 📁 Comparing 6dba89f against latest (e41c7c3)

  🔍 Preview build  

6 files changed · ± 6 modified

± Modified

@read-the-docs-community
Copy link
Copy Markdown

Documentation build overview

📚 docs | 🛠️ Build #32969434 | 📁 Comparing 6dba89f against latest (e08ef8f)

  🔍 Preview build  

54 files changed · + 1 added · ± 53 modified

+ Added

± Modified

@ericholscher ericholscher marked this pull request as ready for review June 4, 2026 17:02
@ericholscher ericholscher requested review from a team as code owners June 4, 2026 17:02
@ericholscher ericholscher requested review from agjohnson and Copilot June 4, 2026 17:02
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This pull request updates public-facing terminology so the internal version type name “External” no longer appears in the UI or user documentation, replacing it with the user-facing label “Pull request”.

Changes:

  • Update the external version type display label to “Pull request” via EXTERNAL_TEXT in readthedocs/builds/constants.py.
  • Add Django migrations to update frozen field choices for version-type fields so the admin/model state reflects the new label.
  • Update automation rules documentation to use “Pull request” terminology instead of “External”.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated no comments.

File Description
readthedocs/projects/migrations/0165_alter_automationrulematch_version_type.py Updates frozen choices label for projects.AutomationRuleMatch.version_type to “Pull request”.
readthedocs/builds/migrations/0073_alter_automationrulematch_version_type_and_more.py Updates frozen choices labels for several builds app fields using the external version type.
readthedocs/builds/constants.py Changes the user-facing label for external from “External” to “Pull request”.
docs/user/automation-rules.rst Replaces “External” with “Pull request” in user docs for automation rules.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

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.

3 participants