documented the changes in docs/source/changes.rst
still debugging for issue 28