From time to time, people who have a REST API ask me about automated documentation. There's no one right answer, so I've been meaning for ages to write an article about what the options are. However, it's only been recently that I've felt that I've understood the problems and solutions well enough.
We have covered the BigML API before because of its innovative use of machine learning through an API tied up with very easy to use interface. Think of it as Google Prediction API but without a black box algorithm, and with enhanced real time data visualizations and a much better user interface and crisper documentation.