Sorry to dig this up, but according to what I'm experiencing, this isn't correct.
The value() property of the annotation is what translates to the description field, while notes() is ignored. I was able to confirm this by inspecting the generated JSON for one of my models; even with notes() being the only thing defined in my @ApiModelProperty annotation, description is empty. With notes() and value(), description is defined as value().
I'd like to pose the same question that Marek did, but I know you guys are in the process of defining the newest spec right now, but I figured this information would be relevant.
I'd also like to ask for maybe a point in the right direction so I can add the notes field to the annotation parsing myself for my project, if at all possible.