prettier design doc, fixed curl examples, turned into script