cocoindex-code decisions: why the code looks like this