search

skanarul8002 / mca-hub

MCA Hub is a MERN stack-based department management platform designed to streamline communication and operations between the HOD, professors, and students. It includes roles for Admin, Professors, and Students, enabling functionalities like attendance management, marks assignment, and administrative tasks.
https://mca-hub.vercel.app/
7 stars 14 forks source link

Create CONTRIBUTING.md with Guidelines on Creating Issues, Writing Better Comments, and Submitting PRs #7

Open mahendra3399 opened 1 week ago

mahendra3399 commented 1 week ago

Will Create the CONTRIBUTING.md file to provide clear instructions on how contributors can effectively participate in the project. The updated document should include the following details:

  1. How to Create Issues: Explaining the process of creating an issue, including how to properly describe the problem or feature request. Mention the importance of providing a clear, concise title and a detailed explanation of the issue. Encourage the use of templates if available and emphasize attaching any relevant screenshots, logs, or code snippets.

  2. Writing Better Comments for Issue Assignment: Will Provide guidelines on how contributors should communicate when asking for issues to be assigned. Mention the need for detailing how they plan to approach and solve the issue. Request contributors to include thoughtful and constructive comments to make it easier for maintainers to understand their approach.

  3. How to Create Pull Requests (PRs): Step-by-step instructions on how to submit a pull request, from forking the repo to making changes and submitting the PR. Explaining the importance of maintaining a clean and organized commit history (squash or rebase commits if necessary). Highlighting the need for clear commit messages that explain the changes made, and link the issue being resolved in the PR description.

  4. Time Limit for Assigned Issues: Specifying that once an issue is assigned, contributors will have 1-2 days to solve the issue and submit a PR. Mentioning that failure to meet the deadline may result in the issue being reassigned to someone else.

These updates will help streamline the contribution process and ensure that all contributors are aligned on the best practices for creating issues, providing meaningful comments, and submitting clean pull requests.

Kindly assign me this issue under Hacktoberfest 2024, Thank you!!

skanarul8002 commented 1 week ago

Thanks for creating the issue in MCA_HUB! Before you start working on your PR, please make sure to:

⭐ Star the repository if you haven't already. Pull the latest changes to avoid any merge conflicts. Attach before & after screenshots in your PR for clarity. Include the issue number in your PR description for better tracking. Don't forget to follow @skanarul8002 – Project Maintainer – for more updates! We're excited to see your contribution as part of Hacktoberfest 2024! 🎉 Happy open-source contributing!

skanarul8002 commented 1 week ago

please @mahendra3399 ,⭐ Star the repository and follow me @skanarul8002 if you haven't already.