Skip to content

docs: surface the Tunnel.setup/2 → setup/1 break in the 0.6.7 changelog - #49

Open
GenericJam wants to merge 1 commit into
masterfrom
docs/surface-tunnel-setup-break
Open

docs: surface the Tunnel.setup/2 → setup/1 break in the 0.6.7 changelog#49
GenericJam wants to merge 1 commit into
masterfrom
docs/surface-tunnel-setup-break

Conversation

@GenericJam

Copy link
Copy Markdown
Owner

Closes #25.

@dl-alexandre's literal claim is slightly off — the arity change was in the changelog. But it was a parenthetical at the end of a long ### Fixed bullet about EPMD dist-port collisions, which is not where anyone scanning for breaking changes will find it.

His underlying point holds: MobDev.Tunnel.setup/1 is @doc'd and @spec'd public API that appears in hexdocs, so an out-of-tree caller (his custom deploy Mix task) breaks at compile time. That deserves its own heading.

Pulled it into a ### Breaking section on 0.6.7 with the exact compile error and the one-line fix, marked as noted retroactively so the history stays honest about when it was actually surfaced.

Changelog only — no version bump, since this corrects the record for a shipped release rather than changing code.

🤖 Generated with Claude Code

Reported by @dl-alexandre in #25. His literal claim — that the arity change
isn't in the 0.6.x changelog — is not quite right: it was there, as a
parenthetical at the end of a long "Fixed" bullet about dist-port keying. His
actual complaint stands though. Tunnel.setup/1 is @doc'd, @SPEC'd public API
that shows up in hexdocs, out-of-tree callers break at compile time, and nobody
scanning a changelog for breaking changes reads to the end of a bullet about
EPMD port collisions.

Pulled it into its own "Breaking" section on 0.6.7 with the exact compile error
and the one-line fix, and marked it as noted retroactively so the history stays
honest about when it was actually surfaced.

No version bump: the changelog for a shipped release is being corrected, not
the code.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
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.

mob_dev 0.6: MobDev.Tunnel.setup/2 → setup/1 is an undocumented breaking change

1 participant