prep release

[ikiwiki.git] / doc / basewiki.mdwn

diff --git a/doc/basewiki.mdwn b/doc/basewiki.mdwn
index 5ddfab7ebf36e66b2a49934d4de90131625ff1f7..8392884ebc6c62d9d58a5819f35c1efaadeb9be8 100644 (file)
--- a/doc/basewiki.mdwn
+++ b/doc/basewiki.mdwn
@@ -4,18 +4,23 @@ versions.
 
 It currently includes these pages:
 
-* index (not the one in this wiki)
-* sandbox (not the on in this wiki)
-* [[blog]]
-* [[HelpOnFormatting]]
-* [[markdown]]
-* [[openid]]
-* [[pagespec]]
-* [[PreprocessorDirective]]
+* [[index]]
+* [[sandbox]]
 * [[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],
+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.