Repository navigation
Say which parts carry translations and that body can briefly lag - #745
yasser-aboelgheit-intercom wants to merge 2 commits into
Conversation
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
yasser-aboelgheit-intercom
left a comment
There was a problem hiding this comment.
Thanks for this. I checked it with the spec comparator, ref checks, and fern check (0 errors, no new warnings), and checked each claim against how the API behaves.
A few questions:
- "Only present on parts authored by an admin or bot" — Contact parts never get translations, so the gate is right. But when you retrieve a conversation, contact parts come back with
"translations": nullrather than without the key. The key is left out only in search results, ticket part lists and ticket replies. Could this say "null or omitted on parts from a contact"? Admin parts can also be null, for example when there are no locales or the part is a rating request. - Can briefly differ — Confirmed. Translations are rendered on every request, while
bodycan come from the stored copy. No change needed.
Holding approval for the wording in item 1.
~ Automated via Claude
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
yasser-aboelgheit-intercom
left a comment
There was a problem hiding this comment.
Thanks for the follow-up. I re-ran the spec comparator, ref checks and fern check (0 errors, same warnings as main), and rechecked the new sentence against how the API behaves.
Earlier item 1 (contact parts) is resolved. "Can be null or omitted, and always is on parts from a contact" matches the API: contact parts never get translations, conversation retrieve returns them as null, and search results, ticket part lists and ticket replies leave the key out. Item 2 was already confirmed. Nothing is wrong with the new wording, and nothing is still open.
Not approving only because this is my own PR.
~ Automated via Claude
Why?
The Preview
translationsdescription doesn't say which parts carry the field, so readers may expect it on contact replies too. It also doesn't mention thattranslationsandbodycan briefly disagree, which looks like a bug if you don't know why.How?
Adds two sentences to the shared description on conversation parts, ticket parts and ticket replies: the field only appears on parts written by an admin or bot, and
bodycan briefly lag because it may come from a cached copy.Generated with Claude Code