documentation

.D........ [DEV-2201] fixed incorrect chronological order, incorrect description placement of API changes (should be in other API methods), other problems like naming and formatting issues