I keep running into the same label meaning different things across tools — “Archive” hides in Linear, removes from the inbox in Gmail, and “Sync” is sometimes real-time, sometimes just a manual refresh; this keeps showing up… Yesterday it bit me switching between Linear and Gmail around 9am; how do you get teams on the same page about vocabulary, or do you just live with the mismatch?
you get teams on the same page about vocabulary, or do you just live with the mismatch? We wrote a 10-line glossary in Notion and pinned it in Slack and Linear; each term maps to per‑app behavior (e.g., Archive = hide in Linear, keep‑searchable in Gmail), and we bake the link into issue/email templates — small caveat: it drifts unless one person reviews it monthly.
Short answer from my side: I’m seeing the same pattern — one concrete thing that helped was writing down the exact handoff and timebox it to 15–20 min. Does that match what you’re running into?
Building on @jackson_ste, we picked a canonical verb per action and lint our docs with Vale so ‘Archive (Gmail)’ vs ‘Archive (Linear)’ is explicit, plus we bake the hint into issue/PR templates. It’s a little fussy at first, but it beats definition bingo at 9am.