Skip to content

Latest commit

 

History

History
90 lines (60 loc) · 2.45 KB

pull-request.md

File metadata and controls

90 lines (60 loc) · 2.45 KB
Raw

Contributing a pull request

Previous: Notes for Box employees | Next: Updating dependencies

To contribute a change we suggest you do one of the following actions.

  • File an issue - if you found an issue or a bug and you do not have the time or resources to contribute a change, then please open an issue.
  • Send a pull request - if you want to contribute to the Box OpenAPI specification, you can directly start working on your code and open a pull request.

Best practices

Step 1: Fork this repository in GitHub

This will create your own copy of our repository. If you are a Box employee then you can request access to this repository and directly push changes to it.

Step 2: Clone the fork of your branch

git clone [email protected]:{username}/box-postman.git box-postman
cd box-postman

Step 2: Create a feature branch

Create a branch with a descriptive name, such as fix-responses-bug. If you are a Box employee, we recommend mentioning the DDOC ticket name in the branch name.

git checkout -b ddoc-123/fix-responses-bug

Step 3: Add the upstream

When working in your own repository, we recommend adding this repository as the upstream remote. This will allow you to pull in any changes from the upstream repository as they happen.

git remote add upstream [email protected]:box/box-postman.git

Step 4: Push your feature branch to your fork

As you make changes, continue to push the changes to your feature branch. When working on multiple tickets, please use a different feature branch for each feature.

Step 5: Rebase

Before sending a pull request, rebase against upstream, such as:

git fetch upstream
git rebase upstream/main

This will add your changes on top of what's already in upstream, minimizing merge issues.

Step 6: Run the tests

Before opening a pull request, make sure to run tests to make sure nothing broke.

yarn test

Resolve any warnings and errors before making a pull request.

Step 7: Send the pull request

Send the pull request from your feature branch to us. Be sure to include a description in your commit message (not the pull request description) that lets us know what work you did.

Keep in mind that we like to see one feature addressed per pull request, as this helps keep our git history clean and we can more easily track down issues.

Next: Updating dependencies