Skip to content

Latest commit

 

History

History
68 lines (57 loc) · 2.89 KB

PULL_REQUEST_GUIDELINES.md

File metadata and controls

68 lines (57 loc) · 2.89 KB

Pull Request Guidelines for Meteomunch

Thank you for your interest in contributing to Meteomunch! To ensure a smooth and effective review process, please follow these guidelines when submitting a pull request (PR).

Forking Model Workflow

  1. Fork the Repository: Create your own fork of the Meteomunch repository on GitHub.
  2. Clone Your Fork:
    git clone https://github.com/your-username/meteomunch.git
    cd meteomunch
  3. Add Upstream Remote: Add the original repository as a remote named upstream.
    git remote add upstream https://github.com/tinkershack/meteomunch.git
  4. Fetch Upstream Changes: Fetch the latest changes from the upstream repository.
    git fetch upstream
  5. Rebase Your Fork: Rebase your fork's main branch with the upstream main branch.
    git checkout main
    git pull --rebase upstream main
  6. Create a Branch: Create a new branch for your feature or bugfix.
    git checkout -b feature/your-feature-name
  7. Make Your Changes: Write your code and tests.
  8. Run Tests: Ensure all tests pass before committing.
    make test
  9. Commit Your Changes: Commit your changes with a descriptive message.
    git add .
    git commit -a 
  10. Push to Your Fork: Push your branch to your fork on GitHub.
    git push origin feature/your-feature-name
  11. Create a Pull Request: Go to the original Meteomunch repository on GitHub and create a pull request from your fork.

Pull Request Checklist

Before submitting your pull request, please ensure the following:

  1. Descriptive Title and Description: Provide a clear and concise title and description for your pull request. Explain the purpose and motivation behind your changes.
  2. Reference Issues: If your pull request addresses any open issues, reference them in the description using the format Fixes #issue_number or Updates/Related to #issue_number.
  3. Code Style: Ensure your code adheres to the project's coding standards and style guidelines.
  4. Tests: Add tests for your changes and ensure all existing tests pass.
  5. Documentation: Update any relevant documentation to reflect your changes.
  6. Review Your Changes: Double-check your code for any errors or improvements before submitting.

During the Review Process

  1. Be Responsive: Be available to respond to any questions or feedback from the reviewers.
  2. Make Necessary Changes: If requested, make the necessary changes and update your pull request.
  3. Keep Commits Clean: Squash or rebase your commits if necessary to keep the commit history clean and meaningful.

Additional Resources

Thank you for contributing to Meteomunch! Your efforts are greatly appreciated.