Improve changes feed API documentation

  * Remove redundant mention of `_changes resource` since it's already
    describing that resource.

  * Explicitly enumerate all `filter` parameter options with references to doc
    section below for each.

  * Explain the unexpected interaction between ``include_docs``, ``all_docs``
    style and filtering, how the winning document body is returned even if it
    doesn't pass the filtering criteria.

  * Update `POST _changes` doc to say that besides `doc_ids` it is used for
    selector filtering. Also, add an example of using a selector.
1 file changed