update readme

@duncanjw can you please review it?
what about `<location>` ?