А в чью пользу – в пользу реального поведения измените документацию или наоборот (кмк, последний вариант правильнее)?
Поведение будет приведено в соответствие с документацией.

Насчет комментариев по поводу документации - согласен, что можно добавить определенные уточнения. Я записал это в бэклог.