documentation examples improved