improved client documentation