How to contribute

Submitting changes

Pull requests are welcomed :)

For significant effort or feature work, it is preferred to start by filing an issue to discuss your approach before you start coding.

Hacking / debugging

Simply open the userscript in Tampermonkey's dashboard and hack away
Hit Ctrl+S to save
Refresh the target page to test your changes

Once you're done, copy your script from the dashboard into the actual source file of a clone of this repo. Then propose a pull request.

Testing before a PR

For each PR, make sure:

Version is incremented following semantic versioning
Runs in latest stable Chrome and Firefox without Javascript errors
Works in both dev.azure.com/account and account.visualstudio.com
Customizations work in both light and dark theme
Does not report any issues in eslint (run npm run build)

Testing pull request changes

To test the changes in a pull request:

Disable any versions of the userscript you have enabled (via Tampermonkey)
Install the userscript from the GitHub PR
- Go to the Files Changed tab
- Hit the ... button on the top-right of the file
- Hit View file
- Hit Raw button in the page that comes up
Test
Delete the userscript from the PR
Re-enable any original userscript

Coding conventions

Blocks of code are commented
Follow the conventions as specified in eslint config (roughly, Airbnb JS style)