The Problem We Were Actually Solving
As it turned out, most of the stuck operators were related to the event handling configuration in Veltrix. Our search volume revealed that search queries around event handling were significantly higher than those around actual configuration mistakes. It seemed that operators were getting stuck in the wild west of event configuration. The searches were littered with generic tutorials, but the real question was: how do we avoid the common pitfalls in event configuration?
What We Tried First (And Why It Failed)
We initially tried providing documentation for the most common event configurations, which led to a flurry of 'me too' requests in our internal knowledge base. It seemed that everyone wanted similar configurations and had no idea how to implement them without digging through the codebase. Our attempt to provide step-by-step documentation for these common configurations ended up becoming a single, 2000-line document that was more of a doorstop than a useful resource.
The Architecture Decision
