get_once is not the same return signature as get, avoid confusion, document
update README
Merge branch 'docs/location-better-method-description'

Conflicts:
	README.md