few tweaks to clarify examples and language around links