Problem
docs/consumer-profiles.md:167–168 contains developer planning notes that have no meaning to an external reader:
The package rename is deliberately separate from this refactor. Names can be changed after the dependency boundary is stable.
An adopter reading this doc has no context for:
- What rename is being contemplated
- What the "refactor" refers to
- What the "dependency boundary" means
- Why this paragraph appears in a guide about consumer profiles
This reads as an internal TODO comment that was accidentally included in the public documentation during a refactor.
Fix
Remove these two sentences entirely. If there is a relevant consumer-facing message (e.g., "the stable import path is import base_cli; the package name on PyPI is base-cli"), replace with that instead. Otherwise, the surrounding paragraph is self-contained without these lines.
Problem
docs/consumer-profiles.md:167–168contains developer planning notes that have no meaning to an external reader:An adopter reading this doc has no context for:
This reads as an internal TODO comment that was accidentally included in the public documentation during a refactor.
Fix
Remove these two sentences entirely. If there is a relevant consumer-facing message (e.g., "the stable import path is
import base_cli; the package name on PyPI isbase-cli"), replace with that instead. Otherwise, the surrounding paragraph is self-contained without these lines.