documentation on apply change
bug/doc fix for rank