Merge pull request #5532 from ethereum/docs-style-add-mapping

DOCS: Add mapping guide to style docs

1 files changed, 17 insertions, 1 deletions

diff --git a/docs/style-guide.rst b/docs/style-guide.rst
index 7b48ccad..68fee871 100644
--- a/docs/style-guide.rst
+++ b/docs/style-guide.rst
@@ -809,7 +809,23 @@ possible permutations for function declarations.
 Mappings
 ========
 
-TODO
+In variable declarations, do not separate the keyword ``mapping`` from its
+type by a space. Do not separate any nested ``mapping`` keyword from its type by
+whitespace.
+
+Yes::
+
+    mapping(uint => uint) map;
+    mapping(address => bool) registeredAddresses;
+    mapping(uint => mapping(bool => Data[])) public data;
+    mapping(uint => mapping(uint => s)) data;
+
+No::
+
+    mapping (uint => uint) map;
+    mapping( address => bool ) registeredAddresses;
+    mapping (uint => mapping (bool => Data[])) public data;
+    mapping(uint => mapping (uint => s)) data;
 
 Variable Declarations
 =====================