diff options
| author | Neil Pilgrim <github@kepier.clara.net> | 2019-11-01 03:52:20 -0700 |
|---|---|---|
| committer | Andrew Morgan <1342360+anoadragon453@users.noreply.github.com> | 2019-11-01 10:52:20 +0000 |
| commit | befd58f47bab1b8337032d27a995e08c7dd93a83 (patch) | |
| tree | 165e051d848b4d70367b4fe80d37d65ac01572c0 /CONTRIBUTING.rst | |
| parent | Depublish a room from the public rooms list when it is upgraded (#6232) (diff) | |
| download | synapse-befd58f47bab1b8337032d27a995e08c7dd93a83.tar.xz | |
Document lint.sh & allow application to specified files only (#6312)
Diffstat (limited to 'CONTRIBUTING.rst')
| -rw-r--r-- | CONTRIBUTING.rst | 8 |
1 files changed, 8 insertions, 0 deletions
diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst index a71a4a696b..2fb3a95949 100644 --- a/CONTRIBUTING.rst +++ b/CONTRIBUTING.rst @@ -58,6 +58,14 @@ All Matrix projects have a well-defined code-style - and sometimes we've even got as far as documenting it... For instance, synapse's code style doc lives at https://github.com/matrix-org/synapse/tree/master/docs/code_style.md. +To facilitate meeting these criteria you can run ``scripts-dev/lint.sh`` +locally. Since this runs the tools listed in the above document, you'll need +python 3.6 and to install each tool. **Note that the script does not just +test/check, but also reformats code, so you may wish to ensure any new code is +committed first**. By default this script checks all files and can take some +time; if you alter only certain files, you might wish to specify paths as +arguments to reduce the run-time. + Please ensure your changes match the cosmetic style of the existing project, and **never** mix cosmetic and functional changes in the same commit, as it makes it horribly hard to review otherwise. |