diff --git a/api/shared-types/y.map.md b/api/shared-types/y.map.md
index 8580cf6..7009d28 100644
--- a/api/shared-types/y.map.md
+++ b/api/shared-types/y.map.md
@@ -23,6 +23,10 @@ ymap.set('my nested map', ymapNested)
 ymap.set('prop-name', 'value') // value can be anything json-encodable
 ymap.get('prop-name') // => 'value'
 ymap.delete('prop-name')
+
+// Powerful for simple stuff as toggles as well
+ymap.set('your-toggle', true)
+ymap.get('your-toggle') // => true
 ```
 
 ## API