docs: add Hacktoberfest 2025 welcome guide #161
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Description
This PR adds a comprehensive Hacktoberfest welcome guide (HACKTOBERFEST.md) to help participants understand how to contribute meaningfully to the Cloudinary Laravel SDK during Hacktoberfest 2025.
Changes
Motivation
With Hacktoberfest approaching, having a dedicated guide will help:
Checklist
Additional Notes
This guide emphasizes that all contributions must follow PSR-12 coding standards and include comprehensive tests, as these are non-negotiable requirements for the project. It complements the existing CONTRIBUTING.md by providing Hacktoberfest-specific context and highlighting key areas where help is needed.
The guide includes specific sections for Blade component development (image, video, widget components) and File Storage Driver improvements, which are core features of the SDK. It also addresses the unique nature of this being a Cloudinary Labs project with specific disclaimers.
Special attention is given to the requirement of running
composer test
before submission and maintaining compatibility with PHP 8.2+ and Laravel 11+, which are essential for the package's target audience.Thank you for reviewing this pull request.
Happy Hacktoberfest.