Skip to content

Document that Go SDK registration closes at Serve - #73614

Merged
jason810496 merged 1 commit into
apache:mainfrom
henry3260:go-sdk-docs-registration-closes
Sep 23, 2026
Merged

jason810496 merged 1 commit into
apache:mainfrom
henry3260:go-sdk-docs-registration-closes

Conversation

@henry3260

Copy link
Copy Markdown
Contributor

#73549 enforced two registration rules that the Go SDK docs never stated, so the first sign of either was a panic. This writes them down where a bundle author reads.

  • Serve closes registration. go.rst only said "Because main registers every handler before Serve, a mistake stops the executable as soon as it starts" — a description of the convention, not of any enforcement. A Register left below Serve now panics; the rst gains a paragraph saying so, and the README the same in one sentence.
  • A variadic task function is rejected at registration. The "for instance" list of signature failures covered only a missing airflow.Context and a missing error return. ...T is a natural thing to reach for in the argument-binding section, and no stub argument can fill it, so it is now named alongside the other two.

The doc comments on Register/Serve already carry both (#73549); this is the user-facing half.

related: #73549


Was generative AI tooling used to co-author this PR?
  • Yes — Claude Code (Opus 5)

Both rules were enforced in code without being written down anywhere a
bundle author reads, so the first sign of either was a panic: one at
startup, one on the task's first run under the supervisor.

@jason810496 jason810496 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the follow-up.

@jason810496
jason810496 merged commit 43f0cfd into apache:main Sep 23, 2026
70 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants