knuckleswtf / scribe

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

API Guide #839

Closed wcostaprijo closed 1 week ago

wcostaprijo commented 1 month ago

Scribe version

4.35

Your question

Is it possible to create an API Guide using this library with Laravel?

[ x ] Laravel 11.x [ x ] Scribe 4.35

Docs

shalvah commented 1 month ago

What do you mean by an API guide?

wcostaprijo commented 1 month ago

An API Guide provides a comprehensive and contextual overview of the API, including detailed descriptions of concepts, step-by-step guides, usage examples, best practices, and perhaps even tutorials. This documentation is typically more focused on helping developers understand how to use the API in their own projects, providing guidance and insights on how to make the most of the API's features.

Captura de tela de 2024-05-01 11-36-49

AryaSvitkona commented 1 week ago

@wcostaprijo You mean something like that? https://adidas.gitbook.io/api-guidelines (see for others: https://apistylebook.com/design/guidelines/)

Well I would rather use Gitbook for that and use Scribe to generate the technical documentation :)