Currently, a lot of information for the API spec file is duplicated in the API documentation. This results in huge efforts even when making very small, insignificant changes to the API as we need to duplicate the information back to the API documentation.
With this issue, the suggestion is to have no/very minimum redundant information as a part of the API documentation that is already a part of the spec file.