(no commit message)
[ikiwiki.git] / doc / roadmap.mdwn
index 9d8858505ddd2fe7560a5f5f793091bf62334d00..134ebcb7b11b63360ba65483141ee6778ff096c4 100644 (file)
@@ -7,7 +7,7 @@ This is the roadmap for ikiwiki development.
 
 Released 29 April 2006.
 
-The 1.x series is no longer supported.
+The 1.X series is no longer supported.
 
 ----
 
@@ -56,8 +56,9 @@ The highlights of the changes in version 3.0 include:
   [[rcs/monotone]]
 * Support for [[tips/untrusted_git_push]].
 * A new version (3.00) of the plugin API, exporting additional
-  commonly used functions from `IkiWiki.pm`. Nearly everything in ikiwiki is
-  now a plugin, from WikiLinks to page editing, to RecentChanges.
+  commonly used functions from `IkiWiki.pm`.
+* Nearly everything in ikiwiki is now a plugin, from WikiLinks to page
+  editing, to RecentChanges.
 * Far too many bug fixes, features, and enhancements to list here.
 
 Released 31 December, 2008.
@@ -68,6 +69,26 @@ backwards compatability.
 
 ----
 
+# compatability breaking changes
+
+Probably incomplete list:
+
+* Drop old `--getctime` option.
+* Remove compatability code in `loadindex` to handle old index data layouts.
+* Make pagespecs match relative by default? (see [[discussion]])
+* Flip wikilinks? (see [[todo/link_plugin_perhaps_too_general?]])
+* YADA format setup files per default?
+* Enable tagbase by default (so that tag autocreation will work by default).
+  Note that this is already done for wikis created by `auto-blog.setup`.
+* [[tips/html5]] on by default (some day..)
+* Remove support for old `.ikiwiki/comments_pending` from comment plugin.
+* Use yaml formatted setup files by default. (Not too compatability breaking
+  really.)
+
+In general, we try to use [[ikiwiki-transition]] or forced rebuilds on
+upgrade to deal with changes that break compatability. Some things that
+can't help with.
+
 # future goals
 
 * Conversion support for existing other wikis.