Overview
Navigating the world of package management can be quite a challenge, especially when it comes to contributing and suggesting new packages. This guide focuses on understanding how to effectively add new packages to a community-managed database. It outlines steps for both users looking to recommend packages and developers aspiring to contribute their own. The emphasis is on accuracy, community well-being, and the shared goal of maintaining a curated collection of useful, actively maintained packages.
Participating in this process not only helps enhance the resources available to developers but also fosters a collaborative environment where all contributions are valued. The guidelines emphasize quality over quantity, ensuring that only the best packages make it to the database while maintaining community standards.
Features
- Search Functionality: Before suggesting a new package, utilize the search feature to ensure it’s not already in the database, saving time and effort.
- Batch Submissions: When submitting packages for inclusion, it’s encouraged to compile multiple packages into a single pull request (PR) for efficiency.
- Community Focus: The selection criteria prioritize packages that are useful and actively maintained, rather than simply popular or high-rated.
- Open Communication: Contributors are invited to report bugs or request new features through discussion threads or issues, promoting transparency and collaboration.
- Package Review Process: New packages are evaluated not solely on their star ratings but also on their proven usefulness, considering the overall impact on the community.
- Support for Recent Versions: Packages must support recent versions of Laravel and PHP to ensure compatibility and relevance within the community.
- Easily Reported Issues: Should any discrepancies arise regarding package information, contributors can promptly report them for immediate attention and correction.
- Respectful Interaction: The guidelines encourage a positive atmosphere, asking for understanding if a suggested package isn’t added immediately, underscoring community appreciation.