# 1.0
-Generally usable release.
-
-* No severe [[security]] bugs. (./)
-* All the [[features]] people would expect in a wiki. Needs to be a plausible
- promise of being a wiki that people can commit to [[using|ikiwikiusers]].
- (./)
+* No severe [[security]] bugs.
+* All the basic [[features]] people would expect in a wiki.
Released 29 April 2006.
+The 1.X series is no longer supported.
+
+----
+
# 2.0
-* Unit test suite (with tests of at least core stuff like
- [[PageSpec]]). _(status: exists, could of course use more tests)_
-* [[Plugins]] (./)
-* [[Tags]] (./)
-* Should have fully working [[todo/utf8]] support. (./)
-* [[Optimised_rendering|todo/optimisations]] if possible. Deal with other
- scalability issues. _(status: scales to thousands of pages, and approximatly
- 3.5 times as fast as version 1.0)_ (./)
-* Improved [[todo/html]] stylesheets and templates. _(status: [[css_market]] exists; it could always provide more stylesheets. No alternate templates yet, though.)_
-* Improved scalable [[logo]]. (./)
-* Support for other revision control systems aside from svn.
- See [[about_rcs_backends]] _(status: supports git, tla, mercurial)_ (./)
-* Support for other markup languages than markdown
- _(status: done with rst, textile, etc. Markdown still works best though.)_
- (./)
-* No serious known [[bugs]]
-* No severe-to-moderate known [[security]] issues.
-* Conversion support for existing other wikis.
- (Being worked on for MoinMoin and TWiki by [[Josh_Triplett|JoshTriplett]]
- and Jamey Sharp; support for other wikis should fit into the same
- framework.)
-
-2.0 will also be an opportunity to remove old backwards compatibility
-features and make other changes to the default configuration. Some things
-I'm considering:
-
-* Enabling OpenID by default (and disabling password logins by default).
-* Dropping GlobLists. However, they can lurk in preferences settings in wikis,
- which may make getting rid of them hard, and it may be worth keeping them
- so users can list pages without anding them together.
-* Making page/index.html be the default output filename, rather than page.html.
- _(status: option `usedirs` exists; not yet the default)_
-* Enabling [[plugins/goodstuff]] by default?
-* Possibly making [[PageSpecs|pagespec]] match relative by default, rather than the current absolute
- (see [[Discussion]])
-
-Estimated release date for 2.0: 29 April 2007.
+* New improved URLs to pages via `usedirs`.
+* [[plugins/OpenID]] support, enabled by default.
+* Plugin [[interface|plugins/write]] added, with some 60 [[plugins]] available,
+ greatly expanding the capabilities of ikiwiki.
+* [[Tags]], atom feeds, and generally full-fledged blogging support.
+* Fully working [[todo/utf8]].
+* Optimisations, approximately 3.5 times as fast as version 1.0.
+* Improved scalability to large numbers of pages.
+* Improved scalable [[logo]].
+* Support for additional revision control systems besides svn: git,
+ tla, mercurial.
+* Some support for other markup languages than markdown: rst, textile.
+* Unit test suite, with more than 300 tests.
+
+Released 30 April 2007.
+
+The 2.x series is now in maintenance mode. Only security fixes and fixes for
+really bad bugs will be applied going forward.
+
+----
+
+# 3.0
+
+Version 3.0 is an opportunity to make significant transitions.
+Read [[tips/upgrade_to_3.0]] for the steps you will need to
+follow when upgrading your wiki to this version.
+
+The highlights of the changes in version 3.0 include:
+
+* Support for uploading [[attachments|plugins/attachment]].
+* Can [[plugins/rename]] and [[plugins/remove]] pages and files via the web.
+* [[Web_based_setup|plugins/websetup]].
+* Blog-style [[plugins/comments]] as an alternative to Discussion pages.
+* Many other new plugins including [[plugins/htmlbalance]], [[plugins/format]],
+ [[plugins/progress]], [[plugins/color]], [[plugins/autoindex]],
+ [[plugins/cutpaste]], [[plugins/hnb]], [[plugins/creole]], [[plugins/txt]],
+ [[plugins/amazon_s3]], [[plugins/pinger]], [[plugins/pingee]],
+ [[plugins/edittemplate]]
+* The RecentChanges page is compiled statically, not generated from the CGI.
+* Support for additional revision control systems: [[rcs/bzr]],
+ [[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.
+* Far too many bug fixes, features, and enhancements to list here.
+
+Released 31 December, 2008.
+
+The 3.x series is expected to undergo continuing development for some time,
+adding improvements and new features, but avoiding changes that break
+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?]] and [[todo/do_not_make_links_backwards]])
+* 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` and for
+ pending comments located in the srcdir, rather than transient underlay,
+ from comment plugin. That support makes comment moderation slow as
+ it has to check all the old locations.
+
+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. See [[convert]].
+* [[TODO]], [[bugs]], ...