adding post on what the incentives for creativing machine readable api definitions