Yes, I think we should keep the docs. See my comment here: https://github.com/D-Programming-Language/phobos/pull/1516#discussion_r6014225