From 655c1bdac9dee02bcf7f1a1a9948d2404cd2709c Mon Sep 17 00:00:00 2001 From: Andrew Macgregor Date: Tue, 16 Oct 2012 23:19:54 +0800 Subject: [PATCH] provide valid link for YAGNI --- docs/writing/style.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/writing/style.rst b/docs/writing/style.rst index 528eb2b..fbb41a8 100644 --- a/docs/writing/style.rst +++ b/docs/writing/style.rst @@ -114,10 +114,10 @@ Those two possibilities are better avoided without any strong reason to not follow the syntax that is the closest to the function definition: ``send('Hello', 'World', cc='Cthulhu', bcc='God')``. -As a side note, following YAGNI_ principle, it is often harder to remove an -optional argument (and its logic inside the function) that was added "just in -case" and is seemingly never used, than to add a new optional argument and its -logic when needed. +As a side note, following `YAGNI `_ +principle, it is often harder to remove an optional argument (and its logic inside the +function) that was added "just in case" and is seemingly never used, than to add a +new optional argument and its logic when needed. The **arbitrary argument list** is the third way to pass arguments to a function. If the function intention is better expressed by a signature with an