Skip to content

Latest commit

 

History

History
89 lines (59 loc) · 2.48 KB

pull-request.md

File metadata and controls

89 lines (59 loc) · 2.48 KB

Contributing a pull request

Previous: Adding a new release note | Next: Markdown style guide


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 a new entry, you can directly start working on your content 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 git@github.com:{username}/box-developer-changelog.git box-developer-changelog
cd box-developer-changelog

Step 2: Create a feature branch

Create a branch with a descriptive name, such as new-owner-field. If you are a Box employee, we recommend mentioning the DDOC or APIWG ticket name in the branch name.

git checkout -b ddoc-123/new-owner-field

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 git@github.com:box/box-developer-changelog.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 linters

Before opening a pull request, make sure to run the linters and spell checkers.

yarn lint

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: Markdown style guide