title: API Documentation using OpenAPI Specification with multiple spec at a central place
body: <p>We have a lot of micro services exposing their APIs and we have an API first approach. Each service has its own OpenApi3.0 spec file mostly in yaml or json format in their own git repo.</p>
  <p>However, like other companies in the wild, my team and other internal teams are facing trouble with discovering the API and the documentation around it. I would like to build a central place which can render all the API Specs and make things easily discoverable. May be at par with say Stripe or twitter documentation standards.</p>
  <p>So far, I have found few ways to achieve it :</p>
  <ol>
  <li><p>Use React framework to render Redoc components for each spec separately. Makes it scalable but searching across services could be difficult.</p>
  </li>
  <li><p>Merge all the api specs using some pre-existing tools and convert it to MarkDown to show in Slate or use Docusauras with React Redoc stuff. Merge using <a href="https://www.npmjs.com/package/openapi-merge-cli" rel="nofollow noreferrer">https://www.npmjs.com/package/openapi-merge-cli</a> and widdershins with slate. In a company with several apis , scaling would be an interesting challenge i assume with this approach.</p>
  </li>
  </ol>
  <p>I do not want to rely on SwaggerHub as it ties me to something specific. Again, i am looking for open source stuff with license that permits commercial usage.</p>
  <p>Would love to get some suggestions / experiences or if there exists something similar and i can avoid reinventing the wheel.</p>