Skip to content

Call GetMyNotifications' result notifications, not the Hey! menu - #988

Merged
jeremy merged 1 commit into
mainfrom
notifications-not-hey
Oct 15, 2026
Merged

jeremy merged 1 commit into
mainfrom
notifications-not-hey

Conversation

@jeremy

@jeremy jeremy commented Oct 14, 2026 •

Copy link
Copy Markdown
Member

`GetMyNotifications` described its result as "the user's notification inbox (the "Hey!" menu)". Hey! is the Basecamp 4 name; Basecamp 5 shows notifications in the sidebar (`Pings + Notifications`, with `New for you` and `Previous notifications` sections).

  • `spec/basecamp.smithy`: `Get the current user's notification inbox (the "Hey!" menu).` → `Get the current user's notifications (the "Hey!" menu in Basecamp 4).` The rest of the doc is unchanged.
  • Downstream regenerated with `make generate` (OpenAPI, Go catalog, TS, Ruby, Python, Kotlin, Rust doc comments; Ruby/TS metadata timestamps).

Doc-only: no wire, type or signature change. Checked with `make smithy-check catalog-check go-check-drift ts-check-drift`.

Companion to basecamp/basecamp-mcp-server#229, which renames the MCP server's own text; that repo's tool descriptions come from its own definitions, not this doc.

Overlap

#991 (fix-pass-api-semantics) regenerates the same generated files (ruby/lib/basecamp/generated/metadata.json, types.rb, typescript/src/generated/metadata.ts). Whichever of the two lands second resolves by rebasing onto the new main and rerunning make generate.


Summary by cubic

Updates the GetMyNotifications documentation to describe its result as notifications rather than as the "Hey!" menu, which is the Basecamp 4 name; Basecamp 5 shows notifications in the sidebar. The description now reads "Get the current user's notifications (the "Hey!" menu in Basecamp 4)" so readers who know the old name still find it. Regenerated the downstream SDKs from the Smithy spec; there is no wire, type, or signature change.

Written for commit 8b3c79d. Summary will update on new commits.

View guided diff Turn on auto-fix

Copilot AI balanced review requested due to automatic review settings October 14, 2026 22:24
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 14, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-15T15:18:00.865272Z c02a4dc Manual request
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@github-actions github-actions Bot added typescript Pull requests that update TypeScript code ruby Pull requests that update the Ruby SDK go kotlin spec Changes to the Smithy spec or OpenAPI python Pull requests that update the Python SDK rust Rust SDK labels Oct 14, 2026
Copilot AI previously approved these changes Oct 14, 2026

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🟢 Approved

The changes consistently update documentation and generation timestamps without altering wire behavior, types, or signatures.

0 open findings

What changed in this PR

Clarifies GetMyNotifications documentation across the SDK pipeline without changing API behavior.

Changes:

  • Describes the result as notifications, identifying “Hey!” as the Basecamp 4 name.
  • Propagates the wording through generated documentation and refreshes generation timestamps.

[!TIP]
If you aren't ready for review, convert to a draft PR.
Click "Convert to draft" or run gh pr ready --undo.
Click "Ready for review" or run gh pr ready to reengage.

File Description
typescript/​src/​generated/​services/​my-notifications.ts Updates service documentation.
typescript/​src/​generated/​schema.d.ts Updates schema documentation.
typescript/​src/​generated/​openapi-stripped.json Updates operation description.
typescript/​src/​generated/​metadata.ts Refreshes generation timestamp.
spec/​basecamp.smithy Updates authoritative operation documentation.
rust/​basecamp-sdk/​src/​generated/​services/​my_notifications.rs Updates service documentation.
ruby/​lib/​basecamp/​generated/​types.rb Refreshes timestamp comment.
ruby/​lib/​basecamp/​generated/​services/​my_notifications_service.rb Updates service documentation.
ruby/​lib/​basecamp/​generated/​metadata.json Refreshes generation timestamp.
python/​src/​basecamp/​generated/​services/​my_notifications.py Updates synchronous and asynchronous docstrings.
openapi.json Propagates Smithy description.
kotlin/​sdk/​src/​commonMain/​kotlin/​com/​basecamp/​sdk/​generated/​services/​my-notifications.kt Updates service documentation.
go/​pkg/​basecamp/​catalog/​catalog.json Updates catalog documentation.

🧠 Review effort: Balanced


💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

"Hey!" is the Basecamp 4 name for what Basecamp 5 shows in its
notifications sidebar. The doc now says notifications and keeps "Hey!"
as the Basecamp 4 alias, so a reader who knows the old name still
finds it. Regenerated with make generate.
@jeremy
jeremy force-pushed the notifications-not-hey branch from 8b3c79d to c02a4dc Compare October 15, 2026 15:16
@jeremy
jeremy requested a balanced review from Copilot October 15, 2026 15:16
@jeremy

jeremy commented Oct 15, 2026

Copy link
Copy Markdown
Member Author

@codex review

Copilot AI dismissed their stale review, a newer Copilot review was requested October 15, 2026 15:16
@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. Keep it up!

Reviewed commit: c02a4dca73

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🟢 Approved

The changes consistently update documentation and generation timestamps without altering wire behavior, types, or signatures.

0 open findings

🧠 Review effort: Balanced

@jeremy
jeremy merged commit a509c6e into main Oct 15, 2026
56 checks passed
@jeremy
jeremy deleted the notifications-not-hey branch October 15, 2026 16:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

go kotlin python Pull requests that update the Python SDK ruby Pull requests that update the Ruby SDK rust Rust SDK spec Changes to the Smithy spec or OpenAPI typescript Pull requests that update TypeScript code

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants