anchor.diff:     inferred values (in your case required attribute).
   
      So if you choose to augment the definitions with @ApiParam then you need to be explicit and set the value to true.
  +
  +*Q. How does one write a plugin to for e.g. make default all types required and only some not required?*
  +A.  To do this, you'd have to
  +    - add an alternate type rule for `Optional<T>` see `genericModelSubstitutes` in docket
  +    - implement your own https://github.com/springfox/springfox/blob/master/springfox-spi/src/main/java/springfox/documentation/spi/schema/ModelPropertyBuilderPlugin.java#L26[ModelPropertyBuilderPlugin]
  +    - and override the read only property if you find an `Optional` type. See https://github.com/springfox/springfox/blob/master/springfox-swagger-common/src/main/java/springfox/documentation/swagger/schema/ApiModelPropertyPropertyBuilder.java#L35[here] for an example.
  +
  +    Keep in mind that you need the plugin to fire after this plugin... so order it accordingly
   
   *Q. Why are all my operations not showing in the UI?*
   
  
positive.code: *Q. How does one create rules to substitute list and array items?*
  
  A.  If the following types...
  [source,java]
  ----
      ToSubstitute[] array;
  
negative.code: ----
  
      Need to look like this over the wire...
  
  [source,java]
  ----
      Substituted[] array;
  