Adds entry to style guide closes #2114

Raku · Jun 23, 2018 · 849f90c · 849f90c
1 parent 009af0b
commit 849f90c
Showing 1 changed file with 14 additions and 0 deletions.
diff --git a/writing-docs/STYLEGUIDE.md b/writing-docs/STYLEGUIDE.md
@@ -45,6 +45,20 @@ so it's best to use it from the start.
 
 ## Language
 
+### Unambiguous is better than short
+
+When you have to choose between two sentence structures, opt for the
+unambiguous. 
+
+```
+my %hash = hash;
+my @array = <1 2 3>
+```
+
+In this case, `this code initializes a hash` is short, but
+ambiguous. Opt for `The first line of this example initializes an
+empty hash`.
+
 ### 'say' vs 'put'
 
 While there is no hard and fast rule about which of these routines to use