Skip to content

Commit 655c1bd

Browse files
provide valid link for YAGNI
1 parent f0834bc commit 655c1bd

File tree

1 file changed

+4
-4
lines changed

1 file changed

+4
-4
lines changed

‎docs/writing/style.rst‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -114,10 +114,10 @@ Those two possibilities are better avoided without any strong reason to not
114114
follow the syntax that is the closest to the function definition: ``send('Hello',
115115
'World', cc='Cthulhu', bcc='God')``.
116116

117-
As a side note, following YAGNI_ principle, it is often harder to remove an
118-
optional argument (and its logic inside the function) that was added "just in
119-
case" and is seemingly never used, than to add a new optional argument and its
120-
logic when needed.
117+
As a side note, following `YAGNI <http://en.wikipedia.org/wiki/You_ain't_gonna_need_it>`_
118+
principle, it is often harder to remove an optional argument (and its logic inside the
119+
function) that was added "just in case" and is seemingly never used, than to add a
120+
new optional argument and its logic when needed.
121121

122122
The **arbitrary argument list** is the third way to pass arguments to a
123123
function. If the function intention is better expressed by a signature with an

0 commit comments

Comments
(0)