I'm not sure it needs *more* docs, just differently worded. If we change the name of this to `private` as suggested at the end of comments in this PR, I think it gets a little less tricky to explain in a one-liner.