Improved comments on EntityClient interface