We want to make contributing to this project as easy and transparent as possible.
We actively welcome your pull requests.
- Fork the repo and create your branch from
main
. - Add tests for your code using Common Test.
- If you've changed APIs, update the documentation.
- Ensure the test suite passes using
rebar3 ct
. - Make sure your code passes dialyzer using
rebar3 dialyzer
. - Make sure the code is formatted with
erlfmt
:
$ rebar3 as release escriptize
$ _build/release/bin/erlfmt -w "{src,include,test}/*.{hrl,erl}" "rebar.config"
- If you haven't already, complete the Contributor License Agreement ("CLA").
In order to accept your pull request, we need you to submit a CLA. You only need to do this once to work on any of Facebook's open source projects.
Complete your CLA here: https://code.facebook.com/cla
We use GitHub issues to track public bugs. Please ensure your description is clear and has sufficient instructions to be able to reproduce the issue.
To propose a change to layout rules, please provide an example of original code, current formatted output, proposed formatted output, and the new rule the formatter should follow - please remember the rules should be as generic as possible.
Facebook has a bounty program for the safe disclosure of security bugs. In those cases, please go through the process outlined on that page and do not file a public issue.
Format the project using itself!
By contributing to erlfmt, you agree that your contributions will be licensed under the LICENSE file in the root directory of this source tree.