knuckleswtf / scribe

Generate API documentation for humans from your Laravel codebase.✍
https://scribe.knuckles.wtf/laravel/
MIT License
1.7k stars 303 forks source link

Generating Scribe views from an openapi.yml file #823

Closed medeirosinacio closed 6 months ago

medeirosinacio commented 6 months ago

Scribe version

4.31.0

Your question

Hello, I'm currently exploring Scribe and I'm quite impressed with the tools it offers. However, my Laravel application already has a comprehensive openapi 3.0 specification file with mappings for all routes and written examples.

I've searched, but haven't found a solution. Is there a way to generate Scribe views directly from the openapi.yml file?

Docs

shalvah commented 6 months ago

Unfortunately, no. Scribe isn't the tool for that. There are many tools out there which render OpenAPI to HTML (eg scalar, elements and rapidoc)