docs second pass