client changes / doc blocks