Skip to content

feat(client): improve generated Godoc#2407

Draft
jamietanna wants to merge 6 commits into
mainfrom
feat/client-docs
Draft

feat(client): improve generated Godoc#2407
jamietanna wants to merge 6 commits into
mainfrom
feat/client-docs

Conversation

@jamietanna

@jamietanna jamietanna commented Jun 14, 2026

Copy link
Copy Markdown
Member
  • Validate that a multi-line can't escape

@jamietanna

Copy link
Copy Markdown
Member Author

I've split #2406 out of this one

@mromaszewicz

Copy link
Copy Markdown
Member

I think it's a nice looking improvement in terms of comments. The templates get a tiny bit more complex, but I think that's ok.

@mromaszewicz

Copy link
Copy Markdown
Member

@greptileai please review this draft.

@greptile-apps

greptile-apps Bot commented Jun 15, 2026

Copy link
Copy Markdown
Contributor

Greptile Summary

This PR improves generated Godoc for client and server code. It changes:

  • Adds operation-aware comments for generated client methods.
  • Adds response wrapper details to ClientWithResponses method docs.
  • Prefixes server handler summaries with the generated method name.
  • Updates generated examples and test fixtures to match the new comments.

Confidence Score: 5/5

This looks safe to merge.

  • No blocking issues found in the changed code.

Reviews (2): Last reviewed commit: "DROP-make-generate" | Re-trigger Greptile

Comment thread pkg/codegen/templates/client.tmpl Outdated
Comment thread pkg/codegen/templates/client-with-responses.tmpl Outdated
Comment thread pkg/codegen/templates/client-with-responses.tmpl Outdated
And add an argument by default.
As a follow-up from c5641fd, we can **??**

This provides a more clear **??**, as well as **??**.
To **??**

This introduces a new **??**, which will **??**.
@jamietanna

Copy link
Copy Markdown
Member Author

@greptileai review

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants