This library is one of the open source projects of the Ville de Montréal which is currently under active development and which is also used to operate online services on beta.montreal.com.
Ville de Montreal has adopted a Code of Conduct that we expect project participants to adhere to. Please read the full text so that you can understand what actions will and will not be tolerated.
All work on this library happens directly on GitHub. Both core team members and external contributors send pull requests which go through the same review process.
We will do our best to keep master
in good shape, with tests passing at all times. But in order to move fast, we will make API changes that your application might not be compatible with. We will do our best to communicate these changes and always version appropriately so you can lock into a specific version if need be.
My PR addresses the following Github issues and references them in the PR title. For example, "#XXX My PR" In case you are fixing a typo in the documentation you can prepend your commit with docs: xxxx #XXX, code changes always need a Github issue.
Here are some details about my PR, including screenshots of any UI changes:
- Clarify the documentation.
- No UI changes.
My PR adds the following unit tests OR does not need testing for this extremely good reason:
- It's just a simple documentation change.
My commits all reference Github issues in their subject lines (recommended), and I have squashed multiple commits if they address the same issue. In addition, my commits follow the guidelines from "How to write a good git commit message"
In case of new functionality, my PR adds documentation that describes how to use it.
In order to accept your pull request, we need you to submit a DCO. You only need to add -s
command line option to append this automatically to your commit message.
More details