The best reaction to "this is confusing, where are the docs" is to rewrite the feature to make it less confusing, not write more docs.