7. Pull Request

A Pull Request (PR), Merge Request on other Git hosts, is a request for a project's maintainers to review and merge your changes. It's the standard process for contributing to a project, or the heart of collaboration in open source.

The maintainers will review your PR, make comments, request changes, or approve and merge it.

Very rarely does a PR get merged without asking you for changes first. Don't take it the wrong way, the reviewer knows the project better than you and wants to keep the code quality high.

Open a Pull Request

1. Go to your fork on GitHub
2. You'll see a "Compare & pull request" message - click it
3. Complete the PR form
4. Click "Create pull request"

In summary, the full flow for creating a Pull Request would be:

1. Create a fork of the project (if you haven't already; otherwise you should sync your fork first).
2. Clone your fork locally (or use the one you already have).
3. Create a specific branch for your change (NEVER work directly on main).
4. Make your changes: small, focused commits with clear descriptions.
5. Push to your branch in your fork.
6. From GitHub, open a Pull Request from your branch to the main branch of the original repository.
7. Wait for the review, respond to comments and make changes if necessary.

There's a very common convention for naming branches, as follows:

• feature/description: New feature
• fix/description: Bug fix
• docs/description: Documentation changes
• refactor/description: Code refactoring
• test/description: Add or improve tests

But it's not mandatory; each project can have its own conventions. What matters is that the name is descriptive. A clear, concise text that explains the "why" behind the changes. If you also include screenshots, videos and references to issues, all the better.

Then the review process begins, where you'll receive comments, suggestions and possibly change requests.

Be polite and grateful. Many maintainers are doing this in their free time. Their goal is to improve the project, not to criticize you personally.

Making changes to an existing PR

If the reviewer asks you for changes, keep working on the same branch you used for the PR. New commits will be added to the PR automatically.