title: Describing controller query parameters in PHPDoc
body: <p>My Laravel controller has an index method on it which accepts an optional query string parameter.</p>
  
  <p>How should this be represented in the method's PHPDoc block?</p>
  
  <p>EmployerController.php:</p>
  
  <pre><code>/**
   * @param Request $request
   * @return Response
   * Returns list of Employers
   */
  public function index(Request $request) {
      // This is the optional parameter which needs to be represented
      // in the PHPDoc block
      $collectiveAgreement = $request-&gt;query('collective_agreement');
  
      ...
  }
  </code></pre>