Skip to content

docs: rename 'sidecar' to 'local PMXT service' per 2026-05-27 ADR (v2.49.2)#980

Open
realfishsam wants to merge 1 commit into
mainfrom
docs/rename-sidecar-to-local-service
Open

docs: rename 'sidecar' to 'local PMXT service' per 2026-05-27 ADR (v2.49.2)#980
realfishsam wants to merge 1 commit into
mainfrom
docs/rename-sidecar-to-local-service

Conversation

@realfishsam

Copy link
Copy Markdown
Contributor

Sweeps every user-visible "sidecar" reference in the recently-shipped docs/READMEs/changelog to the canonical "local PMXT service" / "local service" per the 2026-05-27 company-brain ADR "Avoid Sidecar Terminology".

What's in this PR

  • READMEs (root, Python, TypeScript) — Quick Start, "How it works (self-hosted)", and "Self-hosted trading (advanced)" sections updated.
  • docs/concepts/hosted-vs-self-hosted.mdx — one bullet updated.
  • changelog.md — 2.49.0 + 2.49.1 entries' prose rewritten. Historical entries for 2.48.x and earlier intentionally untouched.
  • New 2.49.2 entry documenting this cleanup.

Untouched per ADR scope

  • Internal implementation identifiers (_resolve_sidecar_host, sidecarReadRequest, etc.)
  • Auto-generated artifacts (openapi.json, llms-full.txt) — flow through next regen
  • Historical changelog entries (2.48.x and earlier) — describe what shipped at the time

Coordination note

PR #979 (per-method hosted toggle) currently targets 2.49.2. Whichever PR lands second needs to renumber to 2.49.3 at rebase time. Recommend landing this one first since it's small + pure docs.

….49.2)

Per the company-brain ADR 'Avoid Sidecar Terminology' (2026-05-27),
user-facing references to the local PMXT runtime should not use the
word 'sidecar' — preferred phrasing is 'local PMXT service' (primary)
or 'local service' (when context is unambiguous).

Recent docs/READMEs/changelog content shipped in 2.49.0 / 2.49.1 used
the old term reflexively. This sweep rewrites every user-visible
occurrence to the canonical terms:

- readme.md (root)
- sdks/python/README.md (rendered on PyPI)
- sdks/typescript/README.md (rendered on npm)
- docs/concepts/hosted-vs-self-hosted.mdx
- changelog.md (only the 2.49.0 + 2.49.1 entries; historical entries
  for 2.48.x and earlier stay as-is per the ADR's 'leave history
  alone' principle)

Untouched per ADR scope:
- Internal implementation identifiers (_resolve_sidecar_host,
  _kill_orphan_sidecars, sidecarReadRequest, pmxt-ensure-server, ...)
- Auto-generated files (docs/api-reference/openapi.json,
  docs/llms-full.txt, docs/llms.txt) — flows through next regen

Adds 2.49.2 changelog entry documenting the cleanup.

Coordination note: PR #979 (per-method hosted toggle) currently uses
2.49.2 as its target version. Whichever PR merges second will need to
renumber to 2.49.3 at rebase time.
@mintlify

mintlify Bot commented Jun 8, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
PMXT 🟢 Ready View Preview Jun 8, 2026, 9:40 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

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