v4 doc clarifications