readme: smaller location blocks; better doc