Support comments between the team in each endpoint/markdown

Hi,

If any team uses your product as a design platform for the APIs, they will face a real challenge regarding sharing notes and feedback during the designing process.

It will be better to have one of two options.

  • [ Simple ] A comments per endpoint with resolve status (to close the comment/note once is closed) like GitHub pull request comments
  • [ Advance ] A comment per section (endpoint path, query field, path field, the schema of the request, the schema of the response, …)

This is already in our plans. We intend to implement the features in [Advance], but this will require more time.

I think simple will be working fine for most of the users as first part which doesn’t required a lot of time or changes in UX

We will consider launching a [Simple] version first.

I second that! It was really useful that in postman you could add comments. In my team’s case especially on pre- and post processing scripts, which made test automation code reviews possible and smooth. It would be really nice if this tool supported comments as well, both on API design and testing parts as well, thus boost teamwork! :wink:

I think simple will be working fine for most of the users as first part which doesn’t required a lot of time or changes in UX