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.

Incorrect documentation is often worse than no documentation.