better doc + better output + json example