we now have API documentation for most client APIs Pleroma provides (except websocket) deployed at https://api.pleroma.social . it is generated from the same openapi spec we use to generate parameter validation code, so there shouldn't be any parameters or endpoints missing. there are still some issues like insufficient descriptions, missing possible response codes, some fields not marked as nullable for some endpoints, but in general it should be better than having to go back and forth between three files and mastodon api documentation. please feel free to report any issues