-This plugin implements the [[ikiwiki/directive/map]] [[ikiwiki/directive]].
-The directive generates a hierarchical page map for the wiki.
+This plugin provides the [[ikiwiki/directive/map]] [[ikiwiki/directive]],
+which generates a hierarchical page map for the wiki.
+
+[[!if test="enabled(map)" then="""
+This will create an a map, for the plugins section of this wiki:
+
+ \[[!map pages="(plugins or plugins/*) and !*/*/*"]]
+
+Example:
+
+[[!map pages="(plugins or plugins/*) and !*/*/*"]]
+
+It's also possible to search for specific tags or links:
+
+ \[[!map pages="todo/* and !todo/done and !link(todo/done)"]]
+"""]]