Download the PHP package elalecs/laravel-documenter without Composer
On this page you can find all versions of the php package elalecs/laravel-documenter. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download elalecs/laravel-documenter
More information about elalecs/laravel-documenter
Files in elalecs/laravel-documenter
Package laravel-documenter
Short Description An automated documentation generator for Laravel and Filament projects. It analyzes your project structure, including models, Filament resources, controllers, jobs, events, middlewares, and rules, to create comprehensive Markdown documentation. Ideal for quickly onboarding new developers or maintaining an up-to-date project overview.
License MIT
Informations about the package laravel-documenter
Laravel Documenter
Laravel Documenter is an automated documentation generator for Laravel and Filament projects. Its primary purpose is to generate or extend the CONTRIBUTING.md file of your project, providing a comprehensive overview of your project's structure and components.
Features
- Automatically generates or extends the CONTRIBUTING.md file in your Laravel project
- Documents key components: Models, Filament Resources, API Controllers, Jobs, Events, Middlewares, and Rules
- Uses customizable stubs for flexible documentation formatting
- Helps quickly onboard new developers by providing an up-to-date project overview
- Integrates seamlessly with Laravel and Filament projects
Requirements
- PHP 7.3 or higher
- Laravel 8.0 or higher
Installation
You can install the package via composer:
Configuration
Publish the configuration file:
This will create a config/laravel-documenter.php
file where you can customize the behavior of the package.
Usage
To generate or update your project's CONTRIBUTING.md file:
This command will:
- Analyze your project structure
- Generate documentation for each component (Models, Filament Resources, etc.)
- Create or update the CONTRIBUTING.md file in your project root
You can also generate documentation for specific components:
Available types are: model
, filament
, api
, and general
.
Customization
You can customize the documentation output by publishing and modifying the stub files:
This will copy the stub files to your resources/views/vendor/laravel-documenter
directory. After publishing, update your config/laravel-documenter.php
file to point to your custom stubs:
Important: DocBlocks
For Laravel Documenter to function effectively, it's crucial that your code includes properly formatted DocBlocks. These DocBlocks should be present on:
- Classes
- Methods (especially
handle()
methods in Jobs and Middleware, andpasses()
methods in Rules) - Properties
Include @description
tags in your DocBlocks to provide detailed information about the purpose and functionality of your components.
Example:
The more comprehensive your DocBlocks, the more detailed and useful the generated documentation will be.
Updating
When updating the package, make sure to republish the configuration file and clear the config cache:
Contributing
Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
Please make sure to update tests as appropriate.
For more details on how to contribute, please check our CONTRIBUTING.md file.
License
The Laravel Documenter is open-sourced software licensed under the MIT license.
Credits
All versions of laravel-documenter with dependencies
laravel/framework Version ^8.0|^9.0|^10.0|^11.0
nikic/php-parser Version ^5.1