ok, after our RL discussion I agree we should remove this from the docs. The client can document it separately of course.