explain the cycle that is broken by "map and inline can't generate wikilinks"

[git.ikiwiki.info.git] / doc / basewiki.mdwn

diff --git a/doc/basewiki.mdwn b/doc/basewiki.mdwn
index acc1b3a6098a6a46a34cf35ed74bb0c46785c578..8392884ebc6c62d9d58a5819f35c1efaadeb9be8 100644 (file)
--- a/doc/basewiki.mdwn
+++ b/doc/basewiki.mdwn
@@ -6,16 +6,21 @@ It currently includes these pages:
 
 * [[index]]
 * [[sandbox]]
 
 * [[index]]
 * [[sandbox]]

-* [[blog]]
-* [[HelpOnFormatting]]
-* [[markdown]]
-* [[openid]]
-* [[pagespec]]
-* [[PreprocessorDirective]]

 * [[shortcuts]]
 * [[shortcuts]]

-* [[smileys]]
-* [[subpage]]
-* [[wikilink]]
+* [[templates]]
+* [[ikiwiki/formatting]]
+* [[ikiwiki/markdown]]
+* [[ikiwiki/openid]]
+* [[ikiwiki/pagespec]]
+* [[ikiwiki/directive]]
+* [[ikiwiki/subpage]]
+* [[ikiwiki/wikilink]]

 
 As well as a few other files, like [[favicon.ico]], [[local.css]],
 [[style.css]], and some icons.
 
 As well as a few other files, like [[favicon.ico]], [[local.css]],
 [[style.css]], and some icons.

+
+Note that an important property of the basewiki is that it should be
+self-contained. That means that the pages listed above cannot link
+to pages outside the basewiki. Ikiwiki's test suite checks that the
+basewiki is self-contained, and from time to time links have to be
+removed (or replaced with `iki` [[shortcuts]]) to keep this invariant.