Ok,

should be make this more obvious, in code comments, or even API doc comments?

I think I asked the question because the comment in the test was (for me) misleading