Skip to content

docs(deployment): add mysql:// to environment-variables.mdx's OS_DATABASE_URL example list - #9096

Merged
os-project-manager merged 1 commit into
mainfrom
claude/issue-9075-envvars-mysql-scheme
Aug 16, 2026
Merged

docs(deployment): add mysql:// to environment-variables.mdx's OS_DATABASE_URL example list#9096
os-project-manager merged 1 commit into
mainfrom
claude/issue-9075-envvars-mysql-scheme

Conversation

@os-project-manager

Copy link
Copy Markdown
Collaborator

Fixes#9075

What

content/docs/deployment/environment-variables.mdx's OS_DATABASE_URL row
carries an e.g. example list of connection-string schemes. It named
file:./data.sqlite, postgres://…, mongodb://…, memory:// — omitting
mysql:// even though MySQL was ruled a supported deployment target
(#8739) and both detectDriverFromUrl (runtime) and inferDriverTypeFromUrl
(CLI) infer it via /^mysql2?:\/\//i.

Added mysql://… to the list, in the same one-scheme-per-target style the
row already uses for postgres:// (i.e. no mysql2:// alias spelled out).

Why this shape, and why it's small

Per the issue: this list is explicitly e.g., not a closed instruction like
self-hosting.mdx's OS_DATABASE_URL row (#9053 / PR #9076) — nothing on
the page was untrue before this change, only incomplete. So the fix is a
one-scheme addition, not a rewrite:

  • No second caveat pointer added. The very next row,
    OS_DATABASE_DRIVER, already carries the MySQL dialect-caveat pointer PR
    docs(data-modeling): publish MySQL's two documented degradations as deployer-facing caveats #9052 landed on this page (Read [MySQL dialect caveats](/docs/data-modeling/drivers#mysql-dialect-caveats)…).
    A second pointer one row above it would be redundant, not helpful.
  • mysql2:// intentionally left out, even though the runtime accepts
    it. self-hosting.mdx's equivalent row deliberately names one canonical
    scheme per target and never spells an alias (postgres:// not
    postgresql://, mongodb:// not mongodb+srv://). This page's e.g.
    list follows the same convention already (one scheme each for sqlite/
    postgres/mongodb), so mysql:// alone matches it; data-modeling/drivers.mdx's
    inference table remains the exhaustive alias reference for both
    mysql:// and mysql2://.

Out of scope

Verification

At 657ef16fd (this branch's HEAD):

  • pnpm check:docs-audit-scope — OK (178 hand-written docs in scope; 9
    release-owned pages review-only).
  • pnpm check:docs-redirects — OK (92 redirect entries checked).
  • pnpm check:role-word — OK (43 baselined files, no new occurrences).
  • pnpm check:nul-bytes — OK (5973 files scanned, no raw control bytes).
  • node scripts/pm/dispatch-gates.mjs content/docs/deployment/environment-variables.mdx
    named exactly these three families for the changed path; no anchors or
    page-path links were added, so check:doc-anchors / Check Documentation Links are not implicated by this diff.

Generated by Claude Code


Generated by Claude Code

…BASE_URL example list
The OS_DATABASE_URL row's e.g. list named file:./data.sqlite, postgres://…,
mongodb://…, and memory://, omitting mysql:// even though MySQL was ruled a
supported deployment target (#8739) and the adjacent OS_DATABASE_DRIVER row
already carries PR #9052's MySQL caveat pointer.
Add mysql://… in the same one-canonical-scheme-per-target style the row
already uses for postgres:// (no mysql2:// alias spelled out, matching the
convention self-hosting.mdx's row uses). No second caveat pointer added —
the row one line below already carries it.
Fixes#9075
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011RB4waLuNbdruCo6X9oobm
@os-project-manageros-project-manager added the skip-changeset PR has no user-facing published change; bypasses the changeset gate label Aug 16, 2026 — with Claude
@github-actionsgithub-actionsBot added the documentation Improvements or additions to documentation label Aug 16, 2026
@os-project-manager
os-project-manager marked this pull request as ready for review August 16, 2026 10:14
@os-project-manager
os-project-manager added this pull request to the merge queueAug 16, 2026
Merged via the queue into main with commit d787a57Aug 16, 2026
25 checks passed
@os-project-manager
os-project-manager deleted the claude/issue-9075-envvars-mysql-scheme branch August 16, 2026 10:33
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentationImprovements or additions to documentationsize/xsskip-changesetPR has no user-facing published change; bypasses the changeset gate

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs(deployment): environment-variables' OS_DATABASE_URL example list omits mysql://, one row above the caveat pointer that says MySQL is supported

2 participants

@os-project-manager@claude