A good point. I'd rather have a well documented API which only spits out XML than a poorly documented one which can respond in every language. I'd say, very roughly, documentation, read only, multiple formats, read all data, write.