Content Lighthouse

Field Notes · 28 Jul 2026

Event dictionaries that engineers will actually maintain

Naming conventions fail when they live in a Notion page nobody opens. Put ownership next to the event.

Beautiful event dictionaries die in shared drives. After an Instrumentation Health Check, the teams that keep quality are the ones who assign a named owner per domain — payments, onboarding, collaboration — and require a pull-request checklist item for new events.

Useful conventions we see stick:

  • Verb-first names (invoice_sent, not sentInvoiceEvent2)
  • Properties for context, not new event clones for every button colour
  • Deprecation dates when legacy SDK versions still fire duplicates

If your charts disagree with support tickets, start with the dictionary — not another dashboard theme. Our health check is built for that forensic pass.