Brief document blurb about RestClient

[DiannaHohensee]

No description provided.

[elasticsearchmachine]

Pinging @elastic/es-distributed (Team:Distributed)

[DaveCTurner]

LGTM, although I feel this'd be more discoverable in the javadocs for RestClient instead of tucked away here.

[DiannaHohensee]

this'd be more discoverable in the javadocs for RestClient instead of tucked away here.

I typically view documentation on a particular class as restricted to describing what a class does and how it should be best / safely used. Explaining where and why the class is used by callers would be a layer violation -- the class is just supposed to know about itself. A new package-info.java file in org.elasticsearch.client also seems like the same sort of deal, at the package level: describe what the code does and how to use the code, not who uses the code outside the package.

Were you thinking of somewhere else than class level documentation, or do you think about documentation differently?