Scribe
Scribe stats
- Downloads
- 3.7M
- Stars
- 1,298
- Open Issues
- 37
- Forks
- 225
Generate API documentation for humans from your Laravel codebase.✍
Scribe for Laravel
Scribe is a powerful tool designed to enhance your Laravel, Lumen, or Dingo API development by automatically generating human-friendly API documentation. It simplifies the documentation process, ensuring that you spend less time writing docs and more time coding.
Key Features
-
Rich Output: Generates a visually appealing single-page HTML document equipped with code samples, human-friendly text, and an interactive "Try It Out" feature. Additionally, it supports exporting to Postman collections and OpenAPI specifications.
-
Intelligent Processing: Scribe automatically extracts request parameters from FormRequests or validation rules and can invoke API endpoints to obtain sample responses. It also supports generating examples from Eloquent API Resources or Transformers.
-
High Customizability: The appearance and content of the documentation can be tailored to meet specific needs. Modifications can range from simple text changes to complete UI overhauls. Developers can also integrate custom strategies to enhance data extraction and document endpoints or details not present in the codebase.
Installation and Usage
The documentation for Scribe is comprehensive and provides detailed guidelines on installation, configuration, and usage. It includes instructions for users migrating from mpociot/laravel-apidoc-generator, with specific steps to transition from version 3 to the latest release.
Visit the official Scribe documentation to get started and explore advanced configurations.
Contribution
Contributors are welcome! If you're interested in improving Scribe or adding new features, check out the contribution guide.
For those looking to elevate their API documentation skills further, the developer of Scribe also offers a specialized course on crafting excellent API documentation.
Scribe is continually evolving with enhancements like subgrouping, easier sorting, and automated upgrade commands in its latest version, making it an essential tool for modern API development in Laravel.