readme reorganization; also added instructions on how to change the default API (#15)