This is actually a question: Maybe it would still be good to add a doc here explaining what's going on?