add plugin tag type/comments and tag some pages.

[ikiwiki.git] / doc / plugins / anonok.mdwn

diff --git a/doc/plugins/anonok.mdwn b/doc/plugins/anonok.mdwn
index ae1c87f437f0f421976c32032a10c07d5eb19ac9..407012b54581d276a6742f1c8a5ddf41ee3745a2 100644 (file)
--- a/doc/plugins/anonok.mdwn
+++ b/doc/plugins/anonok.mdwn
@@ -1,5 +1,19 @@
-[[template id=plugin name=anonok included=1 author="[[Joey]]"]]
-[[tag type/auth]]
+[[!template id=plugin name=anonok author="[[Joey]]"]]
+[[!tag type/auth type/comments]]
 
 By default, anonymous users cannot edit the wiki. This plugin allows
-anonymous web users, who have not signed in, to edit any page in the wiki.
+anonymous web users, who have not signed in, to edit any page in the wiki
+by default.
+
+Please think twice before enabling this plugin. If your wiki is accessible
+to the internet, it *will* be subject to spamming if this plugin is
+enabled. Such spam is not only a pain to deal with, but it bloats the
+revision control history of your wiki.
+
+The plugin has a configuration setting, `anonok_pagespec`. This
+[[ikiwiki/PageSpec]] can be used to allow anonymous editing of matching pages.
+
+If you're using the [[comments]] plugin, you can allow anonymous comments
+to be posted by setting:
+
+       anonok_pagespec => "postcomment(*)"