|
1 | | -### 🧑💻 Contribution Guidelines |
| 1 | +# Contributing to GitHub-Automation-Scripts |
| 2 | +Ah, thank you ever so much for gracing us with your oh-so-valuable contributions! We're just thrilled to have you here. |
| 3 | +But wait, hold on! Don't just dive in and contribute your precious time. First, read the [Table of Contents](#table-of-contents) for different ways to help and details about how this project handles them. It will make it a lot easier for us maintainers and smooth out the experience for all involved. The community looks forward to your contributions. 🎉 |
2 | 4 |
|
| 5 | +> And if you like the project, but just don't have time to contribute, that's fine. There are other easy ways to support the project and show your appreciation, which we would also be very happy about: |
| 6 | +> - Star the project |
| 7 | +> - Tweet about it |
| 8 | +Remember, every bit of support, big or small, makes a significant difference, and we truly appreciate every gesture of encouragement you offer. Your appreciation fuels our passion for the project, and we're immensely grateful for your involvement in any form! ❤️🌟🐦 |
3 | 9 |
|
4 | | -## Introduction |
5 | | -Welcome to the GitHub Automation Script project! Here, you will find everything you need to know about automating your GitHub workflows and supercharging your development process. |
6 | | -GitHub is a powerful platform for collaboration and version control, enabling teams and individuals to work together seamlessly on projects of all sizes. However, managing repetitive tasks, ensuring code quality, and streamlining deployment can be time-consuming and error-prone. |
| 10 | +## Table of Contents |
7 | 11 |
|
8 | | -That's where the GitHub Automation Script comes in. |
| 12 | +- [Asking Questions](#asking-questions) |
| 13 | +- [How To Contribute](#how-to-contribute) |
| 14 | +- [Styleguides](#styleguides) |
9 | 15 |
|
10 | | -## Getting Started |
11 | | -We deeply value your enthusiasm for enhancing this project! We warmly welcome your valuable contributions and invite you to participate in elevating it to new heights. |
12 | 16 |
|
13 | | -There are some steps that you need to follow before making any contribution in this project, the following steps are important to get start. |
| 17 | +## Asking Questions |
14 | 18 |
|
15 | | -### Step 1. Fork the Repository |
16 | | - [Fork](https://github.com/sahil-sagwekar2652/GitHub-Automation-scripts) the repo first |
| 19 | +If you want to ask a question, join the 'GitHub Automation scripts' project channel on the GSSoC discord server. To join the project channel, make sure you have the 'GitHub Automation scripts' & 'Contributor' role assigned to you. If you don't have the role assigned to you, you can self-assign it in the [#self-roles](https://discord.com/channels/1099745007172329592/1099745007675646046) channel. |
17 | 20 |
|
18 | | - ### Step 2. Clone the forked Repository |
19 | | - ``` |
20 | | - git clone https://github.com/<your_GitHub_username>/GitHub-Automation-scripts.git |
21 | | - ``` |
22 | | -### Step 3. Set Up Remotes |
23 | | -- Add a reference (remote) to the original repository: |
24 | | - ``` |
25 | | - git remote add upstream https://github.com/sahil-sagwekar2652/GitHub-Automation-scripts.git |
26 | | - ``` |
27 | | - - Add a reference (remote) to your forked repository: |
28 | | -``` |
29 | | -git remote add origin https://github.com/<your_GitHub_username>/GitHub-Automation-scripts.git |
30 | | -``` |
| 21 | +Before you ask a question, it is best to search for existing [Issues](https://github.com/sahil-sagwekar2652/GitHub-Automation-scripts.git/issues) that might help you. It is also advisable to search the internet for answers first. |
31 | 22 |
|
32 | | -### Step 4. Check Remotes |
| 23 | +If you still feel the need to ask a question and need clarification, we recommend the following: |
| 24 | + |
| 25 | +- Provide as much context as you can about what you're running into. |
| 26 | +- Provide details about your OS and environment. |
| 27 | + |
| 28 | + |
| 29 | +## How To Contribute |
| 30 | + |
| 31 | +To start contributing, follow the guidelines given below: |
| 32 | + |
| 33 | +### 1. Fork the Repository |
| 34 | +Fork the repository (https://github.com/sahil-sagwekar2652/GitHub-Automation-scripts) |
| 35 | + |
| 36 | +### 2. Clone the forked Repository |
33 | 37 | ``` |
34 | | -git remote -v |
| 38 | +git clone https://github.com/<your_user_name>/GitHub-Automation-scripts.git |
35 | 39 | ``` |
| 40 | +***NOTE*** |
| 41 | +- If you have an idea for an enhancement or a bug you can first check the [Issues](https://github.com/sahil-sagwekar2652/GitHub-Automation-scripts.git/issues) to see if your question has been asked before. |
36 | 42 |
|
37 | | -### Step 5. Keep Your Local Copy Updated |
38 | | -``` |
39 | | -git pull upstream main |
40 | | -``` |
41 | | -### Step 6. Create a New Branch |
| 43 | +- If you'd like to work on an issue, please ask the creator of the issue to assign it to you. This helps to keep the workflow streamlined. |
| 44 | + |
| 45 | +### 3. Create a New Branch |
42 | 46 | ``` |
43 | 47 | git checkout -b <your_branch_name> |
44 | 48 | ``` |
45 | | -
|
46 | 49 | ## Making Changes |
47 | | -Perform your desired changes to the code base. |
48 | | -
|
49 | | -### Step 7. Track Changes |
50 | | - ``` |
51 | | - # Track the changes |
52 | | - git status |
53 | | -
|
54 | | - # Add changes to Index |
55 | | - git add . or git add <file_name> |
56 | | - ``` |
57 | | -### Step 8. Commit Changes |
58 | | - ``` |
59 | | - git commit -m "Write a meaningful but small commit message" |
60 | | - ``` |
61 | | - ### Step 9. Push Changes |
| 50 | +Perform your desired changes to the code base. |
| 51 | + |
| 52 | +### 4. Track Changes |
62 | 53 | ``` |
63 | | -git push -u origin <your_branch_name> |
| 54 | +git add . |
64 | 55 | ``` |
65 | | -### 10. Compare and Create |
66 | | -- Click on "Compare And Pull Requests" 🔄 |
67 | | -- Make sure your pull request adheres to our contribution guidelines. Pull requests that do not meet the guidelines may be closed or discarded ❌ |
68 | | -- Add an appropriate title and description to your pull request, explaining your changes with suitable explanations and screenshots 📝🖼️ |
69 | | -- Click on "Create Pull Request" to submit your contribution for review ✅ |
70 | 56 |
|
71 | | -We appreciate your understanding and cooperation in following our guidelines. Thank you for your contribution! 🙌 |
72 | | -Follow the existing code style and formatting conventions. |
| 57 | +### 5. Commit Changes |
| 58 | +``` |
| 59 | +git commit -m "Suitable message" |
| 60 | +``` |
73 | 61 |
|
74 | | -Maintain consistency with the overall project structure and organization. |
| 62 | +### 6. Push Changes |
| 63 | +``` |
| 64 | +git push -u origin <your_branch_name> |
| 65 | +``` |
75 | 66 |
|
76 | | -Write clear and concise code with appropriate comments where necessary. |
| 67 | +## Creating a Pull Request |
| 68 | +To create a pull request: |
77 | 69 |
|
78 | | -Ensure your code is free from errors and runs without issues. |
| 70 | +- The pull request should mention the issue it is trying to solve and should be linked to it. Here is a video on how to link PRs to issues - [video link](https://docs.github.com/en/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue#linking-a-pull-request-to-an-issue-using-a-keyword). |
79 | 71 |
|
80 | | -Congratulations! You've made your PR with the desired changes. Once the PR is reviewed, it will be merged into the original codebase for everyone to see and use. |
| 72 | +- Make sure to make the appropriate changes in the README.md file if you are adding a new script or feature. |
| 73 | +- Add an appropriate title and description to your pull request, explaining your changes with suitable explanations and screenshots 📝🖼️ |
| 74 | +- Click on "Create Pull Request" to submit your contribution for review ✅ |
81 | 75 |
|
82 | | -## Thank You! |
83 | | -Thank you so much for considering contributing to GitHub-Automation-scripts project. We appreciate your valuable input, and we hope to see you again soon. 😊 |
84 | | -For any further questions or assistance, please reach out to the project maintainers or refer to the project's documentation. git |
| 76 | +## Styleguides |
| 77 | +This project uses the Flake8 linter to lint the Python code. If you are using VSCode, I would suggest installing the [Flake8 linter extension](https://marketplace.visualstudio.com/items?itemName=ms-python.flake8) for VSCode. |
0 commit comments