cleanup, docs

site/doc/pages/2_StringList_keys.txt

@@ -4,12 +4,15 @@ StringList StringList::keys() const
 :params
 return value : index keys as strings
 
-:see
-0_StringList
-
 :content
-Returns the list indexes as strings from `0` through `size() - 1`.
+Returns the list indexes as strings from `0` through `size() - 1`. Use it when code expects string keys for a list-shaped value.
 
-```cpp
-StringList keys = items.keys(); // {"0", "1", ...}
-```
+:example
+StringList items = split("red,green,blue", ",");
+print(join(items.keys(), ","), "\n");
+
+:see
+>types
+0_StringList
+2_StringList_each
+2_StringList_map