After some excellent feedback from a user, we have published a set of FAQ questions which cover areas which are currently missing from the API documentation.
This list will be updated as new questions come in.
We are also aware that the documentation needs to be updated and we have a task on our To Do list to get this done. Hopfully, this will make using the API easier and clearer for you all.
DOAJ Operations Manager