The API documentation has more than a few typos, errors, and unclear bits. Many of these have been noted in comments over the years and there are 44 bug complaints on Stack Apps. (That's a LOT of activity for Stack Apps).
Other sites also occasionally report API documentation problems. For example, there are at least 4 here on Meta SE.
Currently, documentation apparently needs an SE developer to edit, and the last doc bug to be resolved was 3 years ago!
So, please allow users to edit the documentation. We can fix all those niggling typos. Maybe treat it the same as a tag wiki as far as suggested edits are concerned‡.