template change documentation

2 files changed, 8 insertions, 0 deletions

diff --git a/doc/bugs/No___34__sid__34___in_forms_resulting_in_Error:_Your_login_session_has_expired..mdwn b/doc/bugs/No___34__sid__34___in_forms_resulting_in_Error:_Your_login_session_has_expired..mdwn
index bf0ce2de2..d044ba572 100644
--- a/doc/bugs/No___34__sid__34___in_forms_resulting_in_Error:_Your_login_session_has_expired..mdwn
+++ b/doc/bugs/No___34__sid__34___in_forms_resulting_in_Error:_Your_login_session_has_expired..mdwn
@@ -34,3 +34,6 @@ View source of editing page or preview+edit page shows no "sid" input value. (I
 	<p><b>This template is not up-to-date with the installed version of
 	ikiwiki, and may not behave correctly until updated.</b></p>
 	</TMPL_IF>
+
+> Well, that don't look like as good an idea today.. I've documented the
+> recent template change. --[[Joey]]
diff --git a/doc/usage.mdwn b/doc/usage.mdwn
index 82e443bea..745f97cce 100644
--- a/doc/usage.mdwn
+++ b/doc/usage.mdwn
@@ -113,6 +113,11 @@ configuration options of their own.
   build time. If the templatedir is changed, missing templates will still
   be searched for in the default location as a fallback.
 
+  Note that if you choose to copy and modify ikiwiki's templates, you will need
+  to be careful to keep them up to date when upgrading to new versions of
+  ikiwiki. Old versions of templates do not always work with new ikiwiki
+  versions.
+
 * --underlaydir
 
   Specify the directory that is used to underlay the source directory.