Contribution Guide

Thanks for showing an interest in contributing to Bert!

Submitting Issues

The #1 way you can help to contribute to Bert is to open issues when you bump into an error, think of a better way to implement an existing feature, or come up with a brand new feature that would be cool to add. When submitting issues, make sure to take the following steps:

1. Use a succinct, but descriptive title. For example, if you had an idea for a new feature related to adding oAuth accounts, you might use Add oAuth support.
2. Add a detailed description. The more information you can provide, the better. This applies to features, refactors, and bugs. I don't mind reading if it helps me to understand what's up. Brownie points if you've thought about it enough to add a checklist :)
3. Add the appropriate label. I like to use three labels for issues: feature, refactor, and bug. These correspond to the branching strategy used while writing code (see below). Before you add your issue, make sure to mark the correct label.

Submitting Pull Requests

1. If it doesn't already exist, add an issue for what you'd like to add following the instructions above.
2. Make sure to write your code in plain/vanilla JavaScript.
3. If you're adding CSS, make sure to write it in plain CSS and include no dependencies. Also, make sure to keep in stride with the flagging format of the existing CSS. This helps to keep the code accessible to developers of all backgrounds and makes maintenance easy breezy.
4. Take a look at Git Extras and try to make use of their feature, refactor, and bug patterns. If you're not feeling it, at the very least, name your branches like so: <type>/descriptive_name_#00. For example, when refactoring some code for the login page you might create a branch called refactor/improve_login_flow_#15.
5. When you're ready create a new pull request. I try to be fairly responsive to PR's, issues, and questions, but sometimes I fall behind. If you're eager to get your PR looked at, send me a tweet with a link to your PR that says "BRO, do you even GitHub?!" I'm not kidding. It's embarrassing on purpose. Do it or be ignored at your own peril! /evillaugh

Asking Questions

Yes! I love questions. If you're not sure about something, really anything, feel free to send an email to help@themeteorchef.com and I'll see what I can do :)