@jni Don't worry, it's not your software! Also if it were I would just deflect and say it wasn't, anyway. Hm, I suppose that was probably not very reassuring ... :)
I am prone to thinking I've done something wrong, but in fairness to the authors the specific library I was referencing seems to be new, undergoing rapid change, and has the very best of intentions. (And way better docs than I'd expect for an incubating project like that!)