fixes #2558: added explaination about boolean arguments usage to migrate docs