This document provides a set of guidelines to help you during the contribution process for the "My First Open Source Contribution" project. We're thrilled to have your contribution, and remember, every contribution is valued, no matter how small!
Before sending your pull requests, please ensure that you have read and understood the entire contribution guide. If you have any questions or doubts, don't hesitate to reach out.
We welcome contributions of all kinds, from fixing typos and improving documentation to implementing new features and profiles. If you are new to open source, this is a great project to start with.
Follow these steps to contribute:
- Fork this repository to your GitHub account.
- Clone your forked repository to your local machine.
- Create a new markdown (
.mdx
) file with your GitHub username as the filename (e.g.,your-username.mdx
). - Add your profile information to the markdown file. Include details like your name, bio, skills, interests, and social media links.
- Commit your changes and push them to your forked repository.
- Create a pull request (PR) to the main repository.
- Please do not edit or delete someone else's profile.
- Ensure that your file name is your GitHub username in lowercase (e.g.,
johndoe.mdx
). - Make sure to follow the Markdown and MDX syntax for formatting your profile.
- If you are a participant or contributor, comment on the issue you want to work on, and wait for assignment.
- Issues will be assigned on a first-come, first-serve basis.
- Contributors can open their issues using the issue template, but they need to be verified and labeled by a project admin.
- Once assigned, please discuss with the team before working on the issue.
- Pull requests will be merged after review by a project admin.
- Avoid importing external libraries for basic algorithms. Only use external libraries for more complex tasks.
- Fill out the PR template properly when creating a Pull Request.
- Add your code (
.mdx
file) into the respective folders. - Ensure your work is original, not copied from other sources.
- Comment on your code where necessary for clarity.
- For front-end changes, provide screenshots and work samples before submitting a PR.
- Follow the style guides for your work.
- For any queries or discussions, please feel free to reach out.
Here are some additional guidelines:
- Use snake_case (underscore_separated) in your file names.
- The basic project folder should have two repositories:
Dataset
andModel
. - The
Dataset
should contain related dataset files for the project. - The
Model
should include program files and other relevant files concerning the project for AI, Deep Learning, Computer Vision, NLP, etc. - The README file should provide a concise and clear description of the project.
- Markdown Cheat Sheet
- MDX Documentation
- GitHub Guide: Forking a Repo
- GitHub Guide: Creating a Pull Request
If you need further assistance or have questions about Git, GitHub, or the contribution process, don't hesitate to reach out to the project admins or mentors. We're here to help you on your open source journey!
🎉 🎊 😃 Happy Contributing! 😃 🎊 🎉