more work on client array documentation