Updates according to comments received in pull request
updated documentation fr 1.28 as 1.27 is released