From aeeeb5f4597bc956b02f469008623ac984071e5e Mon Sep 17 00:00:00 2001 From: Armaan <104704093+0Armaan025@users.noreply.github.com> Date: Tue, 31 Oct 2023 23:21:49 +0530 Subject: [PATCH] Create CONTRIBUTING.md --- CONTRIBUTING.md | 92 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 92 insertions(+) create mode 100644 CONTRIBUTING.md diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 00000000..bd854d16 --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,92 @@ +# Contributing to Apache ServiceComb Samples + +Thank you for your interest in contributing to the Apache ServiceComb Samples project. Your contributions can help improve and expand the samples and examples provided with Apache ServiceComb. To ensure a smooth and collaborative experience, please follow the contribution guidelines outlined below. + +## **Submitting Contributions** + +To contribute to this project, please follow these steps: + +### **1. Choose or Create an Issue** + +- Start by reviewing the existing issues to identify areas where your contributions can make a significant impact. +- If you have new sample ideas, enhancements, or bug fixes in mind, you can create a new issue to propose your contributions. Please provide comprehensive details to clearly explain your ideas. + +### **2. Fork the Repository** + +- To initiate your contribution, fork the primary repository by clicking the "Fork" button. This creates a copy of the repository in your personal GitHub account. + +### **3. Clone Your Forked Repository** + +- Clone your forked repository to your local development environment using the following command: + +```bash +git clone https://github.com/your-username/servicecomb-samples.git +``` + +### **4. Set Up the Upstream Remote** + +- Keep a reference to the primary project by adding it as the upstream remote: + +```bash +cd servicecomb-samples +git remote add upstream https://github.com/apache/servicecomb-samples +git remote -v +``` + +### **5. Create a New Branch** + +- Before you start working on your contribution, create a new branch dedicated to your specific sample or task: + +```bash +git checkout -b my-contribution +``` + +## **Working on Your Contribution** + +Now that your development environment is set up and a new branch is created, you can begin working on your contribution. Please follow these guidelines: + +### **6. Make Changes** + +- Implement the necessary changes, including adding or updating sample code, enhancing existing samples, or fixing bugs. Ensure that your contributions are well-structured and documented, aligning with the project's objectives. + +### **7. Commit Your Changes** + +- Commit your changes with informative commit messages that clearly explain the purpose of your contributions: + +```bash +git commit -m "Add a descriptive message here" +``` + +### **8. Push Your Changes** + +- Push the committed changes to your remote repository on GitHub: + +```bash +git push origin my-contribution +``` + +### **9. Create a Pull Request** + +- Visit your repository on GitHub and click the "New Pull Request" button to initiate a pull request from your branch to the primary repository. + +### **10. Await Review** + +- Your pull request will undergo review, and feedback will be provided by the project maintainers or fellow contributors. Be prepared to address any suggested changes or refinements. + +## **Community Engagement** + +While contributing, consider engaging with the community in the following ways: + +### **11. Join Discussions** + +- Participate in discussions related to Apache ServiceComb Samples, share your insights, and collaborate with others to enhance the quality of the provided samples and examples. + +### **12. Share Ideas** + +- If you have innovative ideas for new samples, improvements, or better ways to demonstrate Apache ServiceComb features, don't hesitate to open issues to initiate productive discussions. + +## **Acknowledgment** + +We appreciate your interest in improving Apache ServiceComb Samples. Your contributions are valuable for the project's growth and success. If you have questions or need assistance, please feel free to contact the project maintainers. + +Thank you for your valuable contributions, and we look forward to collaborating with you on the Apache ServiceComb Samples project! 🚀📦🙌