API_DESIGN_18858_ADD_COMMENT

- [ ] edit Specification file 
- [ ] edit class diagram
- [ ] write flow diagram
- [ ] draw sequence diagram