add links and clarify multi-line string section