DOC: document the casting rules changes

Fixes #561.