Skip to content

chore: standardize prebuilt terminology and add vale linting [closes DOC-821]#2958

Draft
Naomi Pentrel (npentrel) wants to merge 1 commit intomainfrom
open-swe/b1dc3811-7695-a6d3-0b98-c0b4232ab7b5
Draft

chore: standardize prebuilt terminology and add vale linting [closes DOC-821]#2958
Naomi Pentrel (npentrel) wants to merge 1 commit intomainfrom
open-swe/b1dc3811-7695-a6d3-0b98-c0b4232ab7b5

Conversation

@npentrel
Copy link
Contributor

Description

The documentation inconsistently used "pre-built", "Pre-built", and "prebuilt" interchangeably. This PR standardizes on "prebuilt" (no hyphen) across all docs, and adds Vale prose linting to prevent regressions.

Terminology decision:

  • "prebuilt" — standardized term (matches langgraph-prebuilt package name, 3.6× more common than "pre-built")
  • "built-in" — kept as-is (semantically distinct: refers to native/inherent features, not ready-made components)

Changes:

  • Replaced all 49 occurrences of "pre-built" / "Pre-built" → "prebuilt" / "Prebuilt" across 36 MDX files
  • Added Vale prose linter configuration (.vale.ini, .github/vale/styles/LangChain/Terminology.yml)
  • Added make lint_prose target to Makefile for running Vale checks locally
  • Vale treats .mdx files as markdown and enforces the terminology substitution rule

Resolves DOC-821

Test Plan

  • vale src/ passes with 0 errors across 2180 files
  • make test passes (103 tests)
  • Verified no remaining pre-built or Pre-built occurrences in src/
  • Verify rendered docs look correct on preview

…se linting to enforce terminology consistency.
@github-actions github-actions bot added ci deepagents For docs changes to Deep Agents javascript langchain For docs changes to LangChain langgraph For docs changes to LangGraph langsmith For docs changes to LangSmith oss python For content related to the Python version of LangChain projects internal labels Mar 6, 2026
@github-actions
Copy link
Contributor

github-actions bot commented Mar 6, 2026

Mintlify preview ID generated: preview-opensw-1772800659-e3813c1

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ci deepagents For docs changes to Deep Agents internal javascript langchain For docs changes to LangChain langgraph For docs changes to LangGraph langsmith For docs changes to LangSmith oss python For content related to the Python version of LangChain projects

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants