Document @ApiProperty.required which is missing currently

for issue https://github.com/wordnik/swagger-core/issues/148