(#22110) Documentation improvements per GH review

* Note that both POST and GET are supported with some historical
  context around the introduction of POST
* Note that the response is an example, and remove the mid-example
  comments, so that the example is cleaner