Docs: Document the most important changes to zen discovery.

Does this include read-only cluster-metadata APIs like Node Stats, Cluster State, etc?  Should probably add a note regardless of what the answer is, just to be explicit.