Document how to add "notes" to method description in the README.

Helps users add "notes" which creates richer documentation when
used with grape-swagger and swagger-ui.