We're excited that you're interested in contributing to the Watchtower project! This document provides guidelines for contributions. Whether you're fixing bugs, proposing new features, or improving documentation, your help is welcome.
-
Fork the Repository
- Start by forking the Watchtower repository to your GitHub account.
-
Clone Your Fork
- Clone your fork to your local machine:
git clone https://github.com/codeforpakistan/watchtower.git
- Navigate into the cloned directory:
cd watchtower
- Clone your fork to your local machine:
-
Create a Branch
- Create a new branch for your changes:
git checkout -b feature/your-new-feature-name
- Create a new branch for your changes:
-
Follow Code Style
- Please keep your coding style consistent with the existing project. Use clear, readable variable names and include comments where necessary.
-
Write Meaningful Commit Messages
- Commit messages should clearly explain what the commit does. Start with a brief summary of changes (max 50 characters), followed by a blank line and a more detailed explanation if needed.
-
Update Documentation
- If you add or change functionality, update the README.md or other relevant documentation.
-
Test Your Changes
- Ensure your changes do not break existing functionality. Add tests if you're adding new features.
-
Push Your Changes
- Push your changes to your fork:
git push origin feature/your-new-feature-name
- Push your changes to your fork:
-
Open a Pull Request
- Navigate to the original "Watchtower" repository you forked.
- Press the "Pull Request" button and choose your branch.
- Title the pull request clearly and provide a description of the changes.
- Link any relevant issues.
-
Review Process
- Once submitted, the project maintainers will review your pull request. Be open to feedback and requests for any changes if necessary.
- Respect the time and effort of maintainers by making clear and concise contributions.
- Maintain a positive and inclusive environment. We do not tolerate harassment of any form.
- Contributions should not include any offensive or harmful material.
By contributing to Watchtower, you agree that your contributions will be licensed under its MIT License.