Skip to content
This repository has been archived by the owner on Jan 10, 2025. It is now read-only.

Latest commit

 

History

History
64 lines (42 loc) · 2.6 KB

CONTRIBUTING.md

File metadata and controls

64 lines (42 loc) · 2.6 KB

Contributing to BigCommerce Developer Documentation

Thanks for showing interest in contributing!

The following is a set of guidelines for contributing to BigCommerce's Developer Documentation. These are guidelines, not rules. Use your best judgment, and make proposed changes to this document in a pull request.

Making a Quick Edit

The easiest way to edit a file is using GitHub's web interface:

  1. Navigate to the file in GitHub. For example, making-requests.md.

  2. Click the pencil icon to Edit This File.

  3. Make the edit.

  4. Type a commit message.

  5. Select Create a new branch for this commit and start a pull request.

  6. Give the branch a descriptive name.

  7. Click Propose file change.

  8. Give the pull request a descriptive title.

  9. Fill in the pull request description.

  10. Click Create pull request.

That's it! You're done.

Editing Locally

For more complex changes, fork and edit locally:

  1. Fork bigcommerce/dev-docs.

  2. git clone the fork to your local machine.

  3. Make edits on a new branch in your IDE of choice.

  4. Commit and push changes to your remote repo.

  5. Create a pull request to bigcommerce:dev-docs/main.

Commit Messages

  • Always include subject; include body when necessary.
  • Use present tense ("Add feature" not "Added feature").
  • Use imperative mood ("Fix broken link..." not "Fixes broken link...").
  • Separate subject from body with a blank line.
  • Limit the subject line to 50 characters.
  • Capitalize the subject line.
  • Do not end the subject line with a period.
  • Use the body to explain what and why versus how.

Style Guides

Contributing to Other Projects

There are many other public BigCommerce repositories accepting contributions. If you're interested in contributing to those projects, see the full list of public source repos. Also, consider joining the BigCommerce Developer Community.