Updating doc. Starting to wrap up for the release, and also issue #89.
The revision of #60 is getting out of control and we're already a
full week late, so we've decided to postpone it for 3.1.5.