Contributions are welcome via pull requests and issues. This project uses the style guides from Dockyard for Ember and JavaScript. These style guides are enforced via Ember Suave. Before submitting a pull request, please make sure all tests pass by running ember test
.
Project communication occurs primarily and intentionally via our project Slack. Those interested in / considering contribution are encouraged to join.
If you're looking for a way to contribute, the Help Wanted tag is the right place to start. Those issues are intended to be bugs / features / enhancements / technologies that have been vetted and we know we want to include in the project.
Needs Requirements is a tag we use to designate that someone analyst interests / skills can/could/is needed to work out and document the requirements for the given issue. Simple requirements (or frankly anything that can be) should be recorded in the issue. More complicated formatting our documentation could be stored in the project wiki. To be honest, we're working this out still. So if you're interested in helping us sort out requirements, email [email protected]
This guide assumes a level of knowledge on how to use GitHub issues and pull requests. If you choose to contribute code, the standard procedure would to do the following:
- Fork the master repo
- Add a comment in the given issue, referencing @tangollama to let our product management function know your intentions.
- Use the GitHub issue to converse regarding requirements.
- Submit a pull request at the point that you feel the feature is "ready to show."
- When opening a PR for a specific issue already open, please use the
address #[issue number]
orcloses #[issue number]
syntax in the pull request description. - Please keep your changes succint in scope. Large pull requests with multiple changes to the codebase (i.e. multiple features) may be asked to be broken into multiple smaller pull requests.
- Please give as much detail as is relevant about your approach to the solution in the pull request description.
- When your code changes include any change to the visual UI, please include a screenshot of how your changes appear in the browser.