jimfuqian/BB2 2821 Add endpoint descriptions to swagger documentation (#1227)

* added description to Swagger doc end points

* cleanup

* address feedbacks, normalization - e.g. use double quotes throughout etc. EP urls de-quotes...

Author: JFU-NAVA-PBC