add list of compatability breaking changes

2 files changed, 15 insertions, 0 deletions

diff --git a/doc/roadmap.mdwn b/doc/roadmap.mdwn
index a701a2685..0c7bf2fa8 100644
--- a/doc/roadmap.mdwn
+++ b/doc/roadmap.mdwn
@@ -69,6 +69,20 @@ 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?
+
+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.
diff --git a/doc/roadmap/discussion.mdwn b/doc/roadmap/discussion.mdwn
index 0b69867bf..8233b1990 100644
--- a/doc/roadmap/discussion.mdwn
+++ b/doc/roadmap/discussion.mdwn
@@ -3,6 +3,7 @@ backwards compatibility problems. Should this be marked as a future plan, perhap
 major version number like 2.0? --Ethan
 
 Yes, I'm looking at making this kind of change at 2.0, added to the list.
+(Update: Didn't make it in 2.0 or 3.0...)
 However, I have doubts that it makes good sense to go relative by default.
 While it's not consitent with links, it seems to work better overall to
 have pagespecs be absolute by default, IMHO. --[[Joey]]