summaryrefslogtreecommitdiff
path: root/docs/internals/contributing/writing-code/coding-style.txt
diff options
context:
space:
mode:
authorTim Graham <timograham@gmail.com>2014-09-04 08:15:09 -0400
committerTim Graham <timograham@gmail.com>2014-09-05 09:22:16 -0400
commit1101467ce0756272a54f4c7bc65c4c335a94111b (patch)
treeddfd451bbc041d69284d3685e351ffc88872780e /docs/internals/contributing/writing-code/coding-style.txt
parentf8bb8436e533abad563b5235cf0e62e42dbc5f01 (diff)
Limited lines to 119 characters in django/
refs #23395.
Diffstat (limited to 'docs/internals/contributing/writing-code/coding-style.txt')
-rw-r--r--docs/internals/contributing/writing-code/coding-style.txt12
1 files changed, 7 insertions, 5 deletions
diff --git a/docs/internals/contributing/writing-code/coding-style.txt b/docs/internals/contributing/writing-code/coding-style.txt
index 9ff58e8b30..c87e28cda8 100644
--- a/docs/internals/contributing/writing-code/coding-style.txt
+++ b/docs/internals/contributing/writing-code/coding-style.txt
@@ -16,11 +16,13 @@ Python style
:pep:`8` is only a guide, so respect the style of the surrounding code as a
primary goal.
- One big exception to :pep:`8` is our preference of longer line lengths.
- We're well into the 21st Century, and we have high-resolution computer
- screens that can fit way more than 79 characters on a screen. Don't limit
- lines of code to 79 characters if it means the code looks significantly
- uglier or is harder to read.
+ An exception to :pep:`8` is our rules on line lengths. Don't limit lines of
+ code to 79 characters if it means the code looks significantly uglier or is
+ harder to read. We allow up to 119 characters as this is the width of GitHub
+ code review; anything longer requires horizontal scrolling which makes review
+ more difficult. This check is included when you run ``flake8``. Documentation,
+ comments, and docstrings should be wrapped at 79 characters, even though
+ :pep:`8` suggests 72.
* Use four spaces for indentation.