Skip to content

Conversation

SachinRajakaruna
Copy link

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

  • Created HACKTOBERFEST.md with detailed contribution guidelines
  • Outlined quality standards specific to Laravel package development
  • Provided clear PSR-12 coding standards requirements
  • Included comprehensive testing requirements and expectations
  • Added development environment setup instructions
  • Listed specific areas where contributions are needed (Blade components, File Storage Driver, etc.)
  • Included pull request checklist and submission process
  • Added Blade component development guidelines
  • Documented version management process for CloudinaryEngine::PACKAGE_VERSION

Motivation

With Hacktoberfest approaching, having a dedicated guide will help:

  • Set clear expectations for code quality and PSR-12 compliance
  • Welcome new contributors to Laravel package development
  • Emphasize mandatory testing requirements for all contributions
  • Reduce low-quality or untested pull requests
  • Guide participants toward meaningful improvements in documentation, Blade components, and features
  • Explain the Cloudinary Labs project status and expectations
  • Provide Laravel 11+ and PHP 8.2+ compatibility guidelines

Checklist

  • Documentation follows project style and tone
  • Content aligns with existing CONTRIBUTING.md guidelines
  • Guide emphasizes PSR-12 compliance and testing requirements
  • PHP 8.2+ and Laravel 11+ requirements are clearly stated
  • Project structure and component development are explained
  • CloudinaryEngine::PACKAGE_VERSION update process is documented
  • Content is welcoming and inclusive for all experience levels
  • Semantic Versioning guidelines are included
  • Cloudinary Labs disclaimer context is provided

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.

Copy link

vercel bot commented Oct 12, 2025

@sachinkanishka is attempting to deploy a commit to the Cloudinary DevX Team on Vercel.

A member of the Team first needs to authorize it.

@devpatocld
Copy link
Collaborator

@SachinRajakaruna Hi! What is the relevant issue related to this PR?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants