Adding Ocelot functionality documentation to downstream swagger

[miraalarab]

Lets say we set Rate Limiting on our endpoint using ocelot. Ideally, the swagger documentation for this would be in the Gateway solution and not in our downstream service. What would be the best way to add this.
Our current idea is to override the json from the downstream and append the possible response. Any better recommendations on how that should/could be done?