Document partial remote read failures / warnings

[juliusv]

See https://github.com/prometheus/prometheus/pull/4832.

We should document:

• in the remote write config docs: how exactly does the partial failure behavior work? (or is there a better place to document this?)
• in the query API docs: document the new warnings field that can be returned.