JSDoc question/suggestion on optional parameters

Hi, Webstorm keeps giving me warnings on the 'redirect' method, because the JSDoc specified two input parameters, both required. There is a JSDoc standard for optional parameters. What is your view on using these in KOA documentation?
http://usejsdoc.org/tags-param.html#optional-parameters-and-default-values

closes #661

lib/response.js

@@ -248,7 +248,7 @@ module.exports = {
    *    this.redirect('http://google.com');
    *
    * @param {String} url
-   * @param {String} alt
+   * @param {String} [alt]
    * @api public
    */