summaryrefslogtreecommitdiff
path: root/doc/tips
diff options
context:
space:
mode:
authorjoey <joey@0fa5a96a-9a0e-0410-b3b2-a0fd24251071>2007-10-09 10:57:11 +0000
committerjoey <joey@0fa5a96a-9a0e-0410-b3b2-a0fd24251071>2007-10-09 10:57:11 +0000
commit6af5bf82902dc31491da50c3e836f03ec1073e48 (patch)
treecd6992a1948f6f4b17e24db5aae77625747ed578 /doc/tips
parent88581b8e72499fc4b6289f9299adc7a832e3e307 (diff)
web commit by http://madduck.myopenid.com/: add info on advantages and disadvantages of usedirs
Diffstat (limited to 'doc/tips')
-rw-r--r--doc/tips/switching_to_usedirs.mdwn11
1 files changed, 11 insertions, 0 deletions
diff --git a/doc/tips/switching_to_usedirs.mdwn b/doc/tips/switching_to_usedirs.mdwn
index d2fed6dda..183ce00ac 100644
--- a/doc/tips/switching_to_usedirs.mdwn
+++ b/doc/tips/switching_to_usedirs.mdwn
@@ -17,3 +17,14 @@ to usedirs, or edit your setup file and turn usedirs back off.
* Now all the URLs to pages in your wiki have changed. See
[[redirections_for_usedirs]] for instructions on setting up redirections
to keep the old URLs working.
+
+Why usedirs?
+------------
+There are several advantages to `usedirs`, including simpler URLs, URLs that
+aren't dependent on the underlying implementation (`.html`), and being able to
+use URLs as tags as described in the [rel-tag
+microformat](http://microformats.org/wiki/rel-tag).
+
+The main disadvantage is that it is harder to browse using `file://` URIs,
+since `file:///dir/` doesn't automatically translate to `dir/index.html`. This
+is something one could fix in the browser though.