One example: Lock entity on swagger definition says lockedBy is a required field, but actually server not always return this field. This make using swagger definition to generate client code very hard.
```
Lock {locked (boolean),
lastLockedDate (string),
lockedBy (
integer):
ID of a user
}
```