From 5ef1b21651fbb15b8fded65d60c7bbb294a76164 Mon Sep 17 00:00:00 2001
From: Joseph Weston <joseph.weston08@gmail.com>
Date: Fri, 3 Jun 2016 18:45:25 +0200
Subject: [PATCH] add whatsnew file for upcoming 1.3 release.

The date is currently missing, and should be provided before
an official release is made.
---
 doc/source/pre/whatsnew/1.3.rst | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)
 create mode 100644 doc/source/pre/whatsnew/1.3.rst

diff --git a/doc/source/pre/whatsnew/1.3.rst b/doc/source/pre/whatsnew/1.3.rst
new file mode 100644
index 00000000..4758e18b
--- /dev/null
+++ b/doc/source/pre/whatsnew/1.3.rst
@@ -0,0 +1,23 @@
+What's new in Kwant 1.3
+=======================
+
+This article explains the user-visible changes in Kwant 1.3.
+Please consult the `full list of changes in Kwant
+<https://gitlab.kwant-project.org/kwant/kwant/compare/v1.3.0...stable>`_ for
+all the changes up to the most recent bugfix release.
+
+Sites in finalized builders have consistent ordering
+----------------------------------------------------
+In Python 3 the internal ordering of dictionaries is not deterministic. This
+meant that running a Kwant script twice would produce systems with different
+ordering of sites, which lead to non-reproducible calculations. Now, sites
+in finalized builders are always ordered first by their site family, then by
+their tag.
+
+Coincidentally, this means that you can plot a wavefunction in a simple 1D
+system by just saying::
+
+    lattice_1D = chain()
+    syst = make_system(lattice_1D)
+    h = syst.hamiltonian_submatrix()
+    pyplot.plot(np.eigs(h)[1][0])
-- 
GitLab