Merge pull request #322 from greg0ire/document_swagger_options

Document Swagger-specific options

Author: soyuka

core/filters.md

@@ -634,7 +634,11 @@ final class RegexpFilter extends AbstractFilter
                 'property' => $property,
                 'type' => 'string',
                 'required' => false,
-                'swagger' => ['description' => 'Filter using a regex. This will appear in the Swagger documentation!'],
+                'swagger' => [
+                    'description' => 'Filter using a regex. This will appear in the Swagger documentation!',
+                    'name' => 'Custom name to use in the Swagger documentation',
+                    'type' => 'Will appear below the name in the Swagger documentation',
+                ],
             ];
         }