improved client docs