title: API Platform: Change description of an endpoint
body: <p>I have created a custom endpoint using API Platform. Here is the annotation I have used: </p>
  
  <pre><code>/**
   * We only want the POST option for now.
   *
   * @ApiResource(
   *      itemOperations={},
   *      collectionOperations={"post"={
   *           "method"="POST",
   *           "controller"=PairingController::class,
   *           "path"="/devices/pairing",
   *           "defaults"={"_api_receive"=false}
   *     }},
   * )
   *
   *
   */
  class Pairing
  {
  ...
  </code></pre>
  
  <p>The controller I am calling executes some custom logic. I am happy with how things are working so far. But the documentation generated by API Platform is now inaccurate. It says:</p>
  
  <blockquote>
    <p>/devices/pairing Creates a Pairing resource.</p>
  </blockquote>
  
  <p>... which is no longer true, since my controller does not generate a pairing. (It calls out to a different API instead, asking that API to do some stuff.)</p>
  
  <p>So here's my question: <strong>How do I change my annotation to allow me to write a custom piece of documentation for this endpoint?</strong></p>