To help in automating the process of integration, it would help to have the documentation in machine readable format to generate clients for the api