Use PendingDeprecationWarning warning for 1.6 release
Update docs according to deprcation policy