some changes, that are needed for PR, documentation changed, ordered the methods the same way it was before, fix some typos