Check out How Lucas Systems Integrated Swagger OpenAPI Definitions with API Explanations by annegentle. Here is an excerpt:
Now available on docslikecode.com, this explanation of how to integrate Swagger with Swashbuckle for a REST API written with C#.
A Pirate’s Life for Me: Documenting APIs with Swagger
In it, Adam Locke, their lone tech writer, describes his troubleshooting process, the toolset including…
The full article is available here.