readme: add expand-url, add notes