From 7b264bcb2d5675708e82d9781d7511238742d288 Mon Sep 17 00:00:00 2001
From: stratact <stratact1@gmail.com>
Date: Sat, 9 Mar 2019 09:40:05 -0800
Subject: [PATCH] :book: Reflect changes for Ion maps

---
 manual/src/variables/03-maps.md | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/manual/src/variables/03-maps.md b/manual/src/variables/03-maps.md
index 42e4e842..c11be16f 100644
--- a/manual/src/variables/03-maps.md
+++ b/manual/src/variables/03-maps.md
@@ -1,17 +1,21 @@
 # Maps
 
-Maps, also known as dictionaries, provide key-value association of data. There are two variants of maps within Ion: BTree and Hash. Hash maps store data in a random order, but are fast; whereas BTree maps keep their data in a sorted order, and are slower.
+Maps, (AKA dictionaries), provide key-value data association. Ion has two variants of maps: BTree and Hash. Hash maps are fast but store data in a random order; whereas BTree maps are slower but keep their data in a sorted order. If not sure what to use, it's best to go with Hash maps.
+
+Creating maps uses the same right-hand-side array syntax. However for design simplicity, users must annotate the type to translate the array into a map.
+
+Please note, the map's inner type specifies the value's type and not of the key. Keys will always be typed `str`.
 
 ## Create a HashMap
 
 ```
-let hashmap:hmap[] = [ foo=hello bar=world fizz=I buzz=was bazz=here ]
+let hashmap:hmap[str] = [ foo=hello bar=world fizz=I buzz=was bazz=here ]
 ```
 
 ## Create a BTreeMap
 
 ```
-let btreemap:bmap[] = [ foo=hello bar=world fizz=I buzz=was bazz=here ]
+let btreemap:bmap[str] = [ foo=hello bar=world fizz=I buzz=was bazz=here ]
 ```
 
 ## Fetch a variables by key
@@ -43,4 +47,4 @@ echo @values(hashmap)
 
 ```
 echo @hashmap
-```
\ No newline at end of file
+```
-- 
GitLab