--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/docs/changes.rst	Wed May 08 09:23:37 2019 +0200
@@ -0,0 +1,60 @@
+.. -*- coding: utf-8; mode: rst; -*-
+
+=========
+ Changes
+=========
+
+All major changes over the versions are listed here. For breaking
+changes have a look at :ref:`api-changes`, they are listed there in
+detail.
+
+.. include:: ../CHANGES.txt
+
+
+.. _api-changes:
+
+Breaking Changes
+================
+
+0.7
+---
+
+- A major overhaul of how filename extensions are associated with loaders
+  has been done:
+
+  + Filename extensions in :mod:`fnmatch` style are associated with
+    file-mode strings.
+
+    These file-mode strings are associated with loader
+    functions separately via the mapping :py:data:`configmix.mode_loaders`.
+
+  + :py:func:`configmix.set_assoc`, :py:func:`configmix.get_assoc`,
+    :py:func:`configmix.clear_assoc` and
+    :py:func:`configmix.get_default_assoc` are the new names for the old
+    `set_loader()`, `get_loader()`, `clear_loader()` and
+    `get_default_loader()` functions.
+    They are used for associating :mod:`fnmatch` style filename patterns
+    to file-mode strings. Previously they associated loader functions
+    directly.
+
+  + :py:func:`configmix.set_assoc` now requires a :mod:`fnmatch` style
+    pattern instead of just a file extension string (i.e. a plain trailer).
+    The previons dictionary with mapping from filename extensions to loader
+    callables is now a list of tuples containing the :mod:`fnmatch` style
+    pattern and the corresponding loader callable.
+
+
+0.6
+---
+
+- :py:func:`configmix.safe_merge` does now a deepcopy of all source
+  configurations when merging. Changes in configuration instances
+  afterwards will not be reflected in the merged configuration any
+  more.
+
+  The public signature of :py:func:`configmix.safe_merge` has *not*
+  changed.
+
+- The default file encoding when reading INI style files with
+  :py:func:`configmix.ini.load` is now "UTF-8". Previously it was undefined
+  and therefore dependent on the user's locale.