Skip to content

Latest commit

 

History

History
97 lines (67 loc) · 2.29 KB

CONTRIBUTING.md

File metadata and controls

97 lines (67 loc) · 2.29 KB

Contributing

Testing

Install karma-cli

npm install -g karma-cli

Install the dependencies for the project:

npm install

Headless (Using PhantomJS)

npm run test:quick

In browser

Any large changes should be tested in old IEs (we support IE 6!), and any other browsers you can get your hands on.

Sauce Labs automated browser testing

To do automated browser testing with sauce labs first install sauce-connect

brew cask install sauce-connect

Then ensure that you have SAUCE_USERNAME and SAUCE_ACCESS_KEY environment variables set.

Finally run:

karma start --single-run

This will run automated tests with all browsers in the browsers.json file.

To run a subset of browsers, select the ones you want and add them to the --browsers flag of the karma command.

karma start --single-run --browsers sl_ie_6, sl_ie_7

Manual browser testing

If you don't have sauce labs you can do some basic IE testing by using modern.ie.

Releasing

  1. Ensure you have the AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY environment variables set.

  2. Bump the version number

    grunt bump::{major,minor,patch,build}
    
  3. Update the CHANGELOG, and README if necessary

  4. Commit, tag, build, upload to S3, invalidate cloudfront, push to github:

    grunt release
    

Pre-release version

  • Update the release on GitHub to include the release notes and check the "pre-release" checkbox
  • Draft the integration guide changes for docs.bugsnag.com
  • Update and test bugsnag.com with the new version

Standard release

  • Wait for cloudfront to invalidate the symlink
  • Test that exception reporting still works on Bugsnag
  • Release the new integration guides for JavaScript on docs.bugsnag.com, and find and update all references to bugsnag-[major version].js